图像生成
Grok Imagine 系列
xAI Grok Imagine 图像生成与编辑:六个模型共用一套任务接口,全部按张固定价
POST
Grok Imagine 系列
xAI 的 Grok Imagine 图像线,当前有六个模型 ID,全部通过统一任务接口
提交成功后返回
通用的
POST /v1/tasks 提交,也全部按成功出图的固定张价结算——换档只改 model。官方线路的 grok-imagine-image、grok-imagine-image-quality 和 grok-imagine-image-2.0 支持参考图编辑、分辨率选择,参考图按张另计;经济版的 grok-imagine-image-2.0-rev、grok-imagine-1.5-rev 和 grok-imagine-1.5-edit-rev 参数更少、输出档位固定、单价更低。视频生成见 Grok Imagine Video 系列。
快速开始
task_id。用 GET /v1/tasks/{task_id} 查询结果,也可以用 Prefer: wait 在一次调用里等待,或配置 Webhook。
请求参数
string
默认值:"generate"
generate:根据文字生成图片edit:基于参考图改写;必须提供image_urls
edit,区别只在 image_urls 传几张。grok-imagine-image-2.0-rev 和 grok-imagine-1.5-rev 只支持 generate。string
必填
图片描述或编辑指令,中英文均可。
integer
默认值:"1"
出图张数。
grok-imagine-image、grok-imagine-image-quality、grok-imagine-image-2.0、grok-imagine-1.5-rev 和 grok-imagine-1.5-edit-rev 取 1–10;grok-imagine-image 在 edit 下只出 1 张。grok-imagine-image-2.0-rev 取 1–12。string
默认值:"auto"
画面比例,取值集合按模型不同,见可用模型。
grok-imagine-image、grok-imagine-image-quality 和 grok-imagine-image-2.0 默认 auto,由模型决定构图;grok-imagine-image-2.0-rev 默认 1:1。grok-imagine-1.5-edit-rev 不接受这个参数。string
默认值:"1k"
输出分辨率,
1k 或 2k。只有 grok-imagine-image、grok-imagine-image-quality 和 grok-imagine-image-2.0 接受,其余三个模型输出档位固定。string
画质档位,
low 或 medium。只有 grok-imagine-image-2.0 接受,且只在 action: "generate" 下有效;带参考图编辑时不要发送。不传时按分辨率档计价。string[]
参考图 URL 数组,需公网可访问。
action: "edit" 时必填:grok-imagine-image 接受 1–5 张,grok-imagine-image-quality 和 grok-imagine-image-2.0 接受 1–3 张,grok-imagine-1.5-edit-rev 接受 1–5 张。grok-imagine-1.5-rev 在 generate 下也接受参考图,最多 5 张;grok-imagine-image-2.0-rev 不接受。多图参考时数组顺序保留,可在提示词里按顺序指代第一张、第二张。callback_url、callback_events、Prefer: wait、Idempotency-Key 和费用上限请求头见提交任务。
seed 和 mask_url 不支持。以上之外的参数会返回 400,不计费。
限制
计费
六个模型都按成功出图的固定张价结算,generate 与 edit 同价,画幅和提示词长度都不影响价格。计费维度按模型不同:
带参考图时,
grok-imagine-image 和 grok-imagine-image-quality 的单次费用 =(分辨率档价 + 每张参考图单价 × 参考图张数)× 出图张数;grok-imagine-image-2.0 的参考图费用不随出图张数重复,单次费用 = 分辨率档价 × 出图张数 + 每张参考图单价 × 参考图张数。resolution 不在该模型支持的档位内时,按兜底价结算(等于 1k 档)。
单价见 GET /v1/models 返回的 price_config,或控制台「模型市场」。单次调用的实际花费见任务响应里的 cost——整数 quota,500,000 quota = 1 USD,不是美元。
只有成功出图才计费。任务失败、取消,或没有返回可用图片时,全额退款。
响应
任务完成
result.images 返回生成的图片,n 大于 1 时数组里有多个条目。图片链接有有效期,取到后尽快转存。完整字段说明见查询任务状态。
可用模型
画幅取值集合:
- 14 种(
grok-imagine-image、grok-imagine-image-quality、grok-imagine-image-2.0):auto、1:1、3:4、4:3、9:16、16:9、2:3、3:2、9:19.5、19.5:9、9:20、20:9、1:2、2:1 - 7 种(
grok-imagine-image-2.0-rev):1:1、2:3、3:2、3:4、4:3、9:16、16:9 - 5 种(
grok-imagine-1.5-rev):1:1、16:9、9:16、3:2、2:3