POST
使用 grok-imagine-image 或 grok-imagine-image-2.0 生成和编辑图片。API Key 需绑定具有图片权限的 Grok 分组。

请求参数

string
required
模型 ID,示例使用 grok-imagine-image-2.0。可用型号见模型列表。
string
required
画面描述;编辑时说明需要保留与修改的部分。
integer
default:"1"
生成数量,默认 1。数量上限见对应模型说明。
string
常见比例:1:1、16:9、9:16、4:3、3:4、3:2、2:3、2:1、1:2。
string
图片分辨率,取值为 1k 或 2k,不区分大小写。
string
url 或 b64_json,按返回字段读取结果。
object
仅编辑请求:使用 {"url":"https://example.com/image.png"},发送到 /v1/images/edits。
array<object>
多张编辑来源图,最多 3 张;所选模型有更低上限时按模型限制提交。

比例与分辨率

使用 aspect_ratio 设置画面比例,使用 resolution 选择 1K 或 2K。例如,"aspect_ratio": "16:9" 与 "resolution": "1k" 组合表示横版 1K 图片。

返回结果

结果链接请及时下载保存。编辑请求发送至 /v1/images/edits,并携带参考图和编辑提示词。