Grok Imagine Image 2.0

模型 ID 为 grok-imagine-image-2.0。文生图和参考图生成均使用同步 POST https://apimaster.ai/v1/images/generations，请求格式为 JSON，鉴权方式为 Bearer API Key。服务端等待图像生成完成，在 data[] 中返回全部图片。

参考图使用 image_urls。本模型当前不支持客户端 /images/generations/async 或 /images/edits，也不使用 Chat Completions 接口。

快速开始：文生图

先在控制台创建 API Key，替换示例中的 YOUR_API_KEY。

curl --fail-with-body --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "白色桌面上的蓝色陶瓷茶壶与一个橙色小球，柔和的摄影棚灯光",
    "resolution": "1k",
    "quality": "low",
    "aspect_ratio": "1:1",
    "n": 1
  }'

成功响应示意如下，示例 URL 仅表示格式，请读取实际返回值：

{
  "created": 1790147540,
  "data": [{ "url": "https://apimaster.ai/imgs/example-result.jpg" }]
}

n 大于 1 时，遍历整个 data 数组。请及时下载结果；日志中的图片按现有规则保留 3 天，不应作为永久存储。

参数

字段	类型	必填	说明
model	string	是	固定为 grok-imagine-image-2.0
prompt	string	是	描述需要生成的图像，不能为空
resolution	string	否	1k 或 2k，默认 1k，大小写不敏感
quality	string	否	low、medium 或 auto
aspect_ratio	string	否	图像宽高比，例如 1:1、16:9
size	string	否	兼容 1:1 等宽高比，会转为 aspect_ratio；不接受 1024x1024 等像素尺寸，不能与 aspect_ratio 冲突
n	integer	否	输出张数，范围 1–10，默认 1；不能是 0
image_urls	string[]	否	最多 5 张参考图的公开可访问 URL，不能为空或重复

省略 quality 或传 auto 时，无参考图固定使用 low；有参考图固定使用 medium。该选择在计价和发送请求前确定。若希望参考图生成使用低品质，请明确传入 "quality": "low"。

参考图生成

参考图仍调用 /images/generations，在 JSON 中传入 image_urls。请将示例地址换成上游可访问的真实图片 URL；本地文件路径不能作为 URL 使用。n 表示输出张数，与参考图数量无关。

curl --fail-with-body --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "保留参考图中茶壶的形状和颜色，生成两张不同构图的产品展示图",
    "resolution": "2k",
    "quality": "medium",
    "aspect_ratio": "1:1",
    "n": 2,
    "image_urls": ["https://your-public-host.example/reference.png"]
  }'

多张参考图使用 "image_urls": ["https://.../first.png", "https://.../second.png"]，最多 5 张，URL 必须不同。参考图字段不是 image、images 或 mask；本模型不支持这些字段。

Python 示例

安装 requests，设置环境变量 APIMASTER_API_KEY，然后执行：

import os
import requests

response = requests.post(
    "https://apimaster.ai/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["APIMASTER_API_KEY"]},
    json={
        "model": "grok-imagine-image-2.0",
        "prompt": "A blue ceramic teapot on a white table, soft studio lighting",
        "resolution": "2k",
        "quality": "medium",
        "aspect_ratio": "1:1",
        "n": 1,
    },
    timeout=(20, 300),
)
response.raise_for_status()
for item in response.json()["data"]:
    print(item["url"])

需要参考图时，向 json 添加 image_urls 数组。超时不代表任务已取消，请先检查用量日志是否已有结果，避免立即重复提交。

基础价格与最终扣费

以下为 2026-09-23 配置的官方基础价，单位为美元/张。基础价配置位于后台“模型定价 → 图片”，用户最终价格还需乘各项系数。

档位	基础价
1K low	$0.04/张
1K medium	$0.06/张
2K low	$0.06/张
2K medium	$0.08/张
参考图输入	$0.01/张

最终费用 =（实际输出张数 × 档位基础价 + 参考图张数 × $0.01）× 渠道倍率 × 充值系数 × 平台倍率 × 用户/分组系数。

每张参考图在一次请求中收费一次，不再乘输出张数。例如，生成两张 2K medium 并输入一张参考图，基础金额为 $0.08 × 2 + $0.01 = $0.17。

2026-09-23 渠道 255、default 分组实测系数为 0.8 × 1 × 1.2 × 1.05，上述请求扣费 $0.17136。这是该渠道、该分组的核查示例；后续价格以模型广场和用量日志为准。预扣按请求张数计算，成功结算按实际返回张数计算。

日志、超时与错误

在用量日志中查看生成图片，多张结果可点击缩略图切换。详情包含有效品质与分辨率、参考图数量、实际输出数、基础价快照、系数和最终费用；图像费用不按文本 token 数计算。

建议设置至少 180 秒的读取超时，多张 2K 请求预留更长时间。同步等待超时后，任务可能继续完成并补结算，请先查看日志。

情况	处理方式
HTTP 400：非法品质、分辨率、张数、像素尺寸或重复参考图	按参数表修正后再提交；本地参数校验失败不扣费
HTTP 400：使用 /async 或 /images/edits	改用同步 /images/generations；参考图放入 image_urls
身份验证或余额错误	检查 API Key、模型权限和可用余额
同步超时或连接断开	先查用量日志中的任务与结果，避免重复提交

上线验收已覆盖四档出图、一张参考图生成两张输出、两张不同参考图及默认品质，并核对了日志预览、扣费明细和额度变化。