使用 RunComfy 的 API 运行 ideogram/ideogram-v2/generate。 可接受的输入与输出请参阅模型的 数据结构说明。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v2/generate \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A photo of a fashion lookbook spread with a sustainable clothing item. There is a natural cotton dress with a linen tag attached to it. The tag has the text \"Wear the Change You Wish to See\". The background is a sunlit forest. The styling and setting have soft, earthy tones. The text is subtle but stylish, blending into the fabric's texture. The overall look is modern, mindful, and eco-conscious."
}'将 YOUR_API_TOKEN 环境变量设置为您的 API 密钥（在 个人资料中管理密钥），并在每个请求的 Authorization 标头中以 Bearer 令牌形式携带： Authorization: Bearer $YOUR_API_TOKEN。
提交异步生成任务，将立即获得 request_id 以及用于查询状态、获取结果和取消的 URL。
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/ideogram/ideogram-v2/generate \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A photo of a fashion lookbook spread with a sustainable clothing item. There is a natural cotton dress with a linen tag attached to it. The tag has the text \"Wear the Change You Wish to See\". The background is a sunlit forest. The styling and setting have soft, earthy tones. The text is subtle but stylish, blending into the fabric's texture. The overall look is modern, mindful, and eco-conscious."
}'根据 request_id 获取当前状态（"in_queue"、"in_progress"、"completed" 或 "cancelled"）。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"获取指定 request_id 的最终输出与元数据；若任务未完成，响应会返回当前状态，便于继续轮询。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"通过 request_id 取消排队中的任务；进行中的任务无法取消。
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"请提供可公网访问的 HTTPS 地址。确保目标主机允许服务端拉取（无需登录或 Cookie）、未被限流或拦截爬虫。建议：图片 ≤ 50 MB（约 4K），视频 ≤ 100 MB（约 720p 下 2–5 分钟）。私有资源请使用稳定或预签名 URL。
{
"type": "object",
"title": "输入结构",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "提示词",
"description": "必填。描述图片内容、构图、风格以及画面中需要呈现的文字。",
"type": "string",
"default": "A photo of a fashion lookbook spread with a sustainable clothing item. There is a natural cotton dress with a linen tag attached to it. The tag has the text \"Wear the Change You Wish to See\". The background is a sunlit forest. The styling and setting have soft, earthy tones. The text is subtle but stylish, blending into the fabric's texture. The overall look is modern, mindful, and eco-conscious."
},
"style": {
"title": "风格",
"description": "可选择 auto、general、realistic、design、render_3D 或 anime，默认值为 auto。",
"type": "string",
"enum": [
"auto",
"general",
"realistic",
"design",
"render_3D",
"anime"
],
"default": "auto"
},
"aspect_ratio": {
"title": "宽高比（宽:高）",
"description": "可从 11 种宽高比中选择，默认值为 1:1。",
"type": "string",
"enum": [
"3:1",
"16:9",
"16:10",
"3:2",
"4:3",
"1:1",
"3:4",
"2:3",
"10:16",
"9:16",
"1:3"
],
"default": "1:1"
},
"expand_prompt": {
"title": "Magic Prompt",
"description": "自动为输入的提示词补充细节，默认开启。",
"type": "boolean",
"default": true
},
"negative_prompt": {
"title": "反向提示词",
"description": "可选。描述不希望出现在生成图片中的元素。",
"type": "string",
"default": ""
},
"seed": {
"title": "种子",
"description": "用于复现相近结果或生成不同版本的整数，范围为 0–2147483647，默认值为 166035072。",
"type": "integer",
"default": 166035072,
"maximum": 2147483647,
"minimum": 0
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "单张图片 URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "单个视频 URL"
},
"images": {
"type": "array",
"description": "多张图片 URL",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "多个视频 URL",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy 是首选的 ComfyUI 平台，提供 ComfyUI 在线 环境和服务，以及 ComfyUI 工作流 具有惊艳的视觉效果。 RunComfy还提供 AI Models, 帮助艺术家利用最新的AI工具创作出令人惊叹的艺术作品。