Skip to main content
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
必填
六选一,取值见可用模型。
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

相关文档