Skip to main content
POST
模型名兼容提示:本接口同时兼容别名 grok-imagine-1.5-ext,它等价于 grok-imagine-1.5-apimart,两者可互换使用、效果一致。
当前 API 示例与 Body 区域对应 Grok Imagine 1.5grok-imagine-imagegrok-imagine-image-quality 的参数差异请查看下方官方模型章节。三个模型均为异步任务,提交后需要通过任务状态接口查询结果。

Authorizations

string
必填
所有接口均需要使用Bearer Token进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

Body

string
默认值:"grok-imagine-1.5-apimart"
必填
图像生成模型名称支持的模型:
  • grok-imagine-1.5-apimart - Grok 图像生成与编辑(兼容别名 grok-imagine-1.5-ext
示例:"grok-imagine-1.5-ext"
boolean
默认值:"false"
是否在提交图片任务前执行内容审核。
  • true:使用 omni-moderation-latest 审核提示词和输入图片
  • false 或不传:不发起审核请求,不增加审核成本与延迟(默认)
string
必填
图像生成或编辑的文本描述,支持中英文
string[]
参考图 URL 列表。不传为文生图,传入则为图像编辑
  • 该模型支持 1–5 张参考图
  • 仅支持公网可访问的绝对 http://https:// URL
  • 本地图片请先调用 POST /v1/uploads/images 上传,再使用返回的 url
string
默认值:"1:1"
输出图像尺寸支持的格式:
  • 1:1 - 正方形(默认)
  • 16:9 - 横版宽屏
  • 9:16 - 竖版长屏
  • 3:2 - 横版
  • 2:3 - 竖版
integer
默认值:1
生成图像的数量取值范围:1-10(最少 1 张,最多 10 张)⚠️ 注意: 必须输入纯数字(如 1),不要加引号,否则会报错

Response

integer
响应状态码
array
返回数据数组

使用场景

场景 1:文生图

场景 2:文生图(指定尺寸与数量)

场景 3:图像编辑(改背景)

场景 4:图像编辑(风格化)

官方模型

grok-imagine-imagegrok-imagine-image-quality 提交后返回任务 ID。请通过获取任务状态接口轮询,直到任务完成或失败。
这两个模型不要发送 quality。不传 image_urls 时为文生图;传 1 张时为单图编辑;传多张时为多图参考。grok-imagine-image 最多支持 5 张参考图,grok-imagine-image-quality 最多支持 3 张。

请求头

请求参数

aspect_ratio 允许值:1:13:44:39:1616:92:33:29:19.519.5:99:2020:91:22:1auto
新接入不要发送像素尺寸字符串。画面比例由 aspect_ratio 控制,清晰度档位由 resolution 控制。

文生图示例

多图参考示例

多图参考时,可按数组顺序在提示词中使用 <IMAGE_0><IMAGE_1> 等占位符引用图片;grok-imagine-image 最多可引用到 <IMAGE_4>grok-imagine-image-quality 最多可引用到 <IMAGE_2>

参考图要求

image_urls 仅接受公网可访问的绝对 http://https:// URL。本地图片请先调用 POST /v1/uploads/images 上传,再使用返回的 url
  • 数组顺序会保留;
  • 重复图片按多张输入处理并按张计费;
  • 没有参考图时省略字段,不要发送空数组。

任务提交响应

202
任务 ID 位于 data.id。使用 data.poll_urlGET /v1/tasks/{task_id} 查询任务状态,直到状态变为 completedfailed

预估价格

报价参数应与生成请求保持一致:modelnaspect_ratioresolution,并将 image_urls.length 作为 input_images。页面只展示服务端返回的 data.final_usd,不要硬编码价格或自行计算最终金额。

幂等与重试

每次用户确认的一次逻辑生成创建一个 Idempotency-Key。同一次请求的网络重试必须复用原 Key、原请求 Body 和原 X-APIMart-Response-Version;用户修改模型、提示词、图片或其它参数后再创建新 Key。