Grok Imagine Image 参数与接口差异
了解 Grok 图像模型的生成参数、参考图格式和编辑限制。
适用模型
| 模型 | 支持的接口 |
|---|---|
| grok-imagine-image-2.0 grok-imagine-image | 创建图片、编辑图片 |
型号参数差异
2.0 的参数说明来自 xAI 文档。当前测试渠道暂无 2.0,平台兼容性待验证。
| 字段 | 差异说明 |
|---|---|
quality | 2.0 支持 low、medium、auto。默认 auto,生成时使用 low,编辑时使用 medium。使用 grok-imagine-image 时省略此字段。 |
aspect_ratio | 2.0 在生成和编辑时支持 21:9 和 5:2。2.0 多图编辑省略此字段时沿用第一张参考图的宽高比。 |
images | grok-imagine-image 使用两张参考图实测通过。可传 URL 字符串数组,或传包含 type: "image_url" 和 url 的对象数组。xAI 文档列出 2.0 最多可传 5 张参考图。 |
单图编辑
使用 grok-imagine-image 编辑单张图片时,请提供公网可访问的 HTTPS 图片地址。两种 image 写法如下。
| 写法 | 请求字段 |
|---|---|
| 推荐 | image: {"url":"https://example.com/input.png"} |
| 兼容 | image: "https://example.com/input.png" |
需要直接取得图片数据时,可指定 response_format: "b64_json",并读取 data[].b64_json。