Create image

x-ai/grok-imagine-image-2.0 的文生图。走 OpenAI Images 兼容端点，官方 SDK 把 base_url 指过来即可。

这个模型不支持流式。

鉴权

header

Authorizationstring必填

Bearer <你的 Amux 密钥> 站内 API Key。

请求

application/json

modelstring必填

站内模型 ID，可带 :供应商 后缀锁定供应商。

promptstring必填

提示词。

ninteger默认 1

出几张（1–10，默认 1）。按张计费，预扣也按张乘。

aspect_ratio"1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "2:1" | "1:2" | "21:9" | "5:2" | "19.5:9" | "9:19.5" | "20:9" | "9:20" | "auto"默认 "1:1"

出图比例，默认 1:1。与上游支持的取值完全一致，共十六个：

1:1 4:3 3:4 3:2 2:3 16:9 9:16 2:1 1:2 21:9 5:2 19.5:9 9:19.5 20:9 9:20 auto

比例只改变产物形状，不改变计费档位——十六个实测同价。

取值域之外的比例会被丢弃并在 amux.notes 中说明，不会替你猜一个。

image_size"1K" | "2K"默认 "1K"

分辨率档。1K（默认）或 2K。不支持 4K。

它同时决定产物格式：1K 出 JPEG，2K 出 PNG。实际格式以响应中的地址后缀为准。

未提供时按 1K 发出——档位会显式写进上游请求，不依赖上游默认值。

quality"low" | "medium" | "auto"默认 "low"

渲染质量。low（默认）/ medium / auto。不支持 high，该模型的上游会明确拒绝这个取值。

auto 等同于 low。未提供时按 low 发出——档位会显式写进上游请求，不依赖上游默认值（上游的默认档在生成与编辑两条端点上并不一致）。

moderation"auto" | "low" | "high"默认 "auto"

内容审核强度。auto（默认）/ low / high。

userstring

端用户标识，用于滥用追踪。不需要就整个别传。

响应

200response

出图成功。

400response

请求不合法，或用了这个模型不支持的能力（如流式）。

402response

可用余额不足以覆盖这次请求的预扣上界。

503response

没有可用供应商，或在途任务已满。

尺寸与格式#

尺寸由两个参数表达：aspect_ratio（比例）与 image_size（分辨率档）。 这个模型不接受 size（精确像素串），传了会被丢弃并在 amux.notes 中说明。

其余比例按同一档位缩放，逐个取值见下一节。不支持 4K。

比例只改变产物形状，不改变计费档位；分辨率档会改变。

⚠️ 产物格式跟着 image_size 走，不可指定——output_format 与 output_compression 在这个模型上都不生效。以响应地址的后缀为准。

quality#

low（默认）/ medium / auto。不支持 high——上游会明确拒绝该取值。 auto 等同于 low。

quality 与 image_size 共同决定计费档位，四种组合各有各的价， 详见模型详情页的价格表。

⚠️ 未提供时我们会显式发出 low，而不是交给上游去挑默认值。 上游在生成端点与编辑端点上的默认档并不一致，显式发出才能保证 「按哪一档计费」与「上游按哪一档收费」始终是同一档。

比例#

出图比例，默认 1:1。与上游支持的取值完全一致，共十六个：

比例只改变产物形状，不改变计费档位——十六个比例实测同价。

取值域之外的比例会被丢弃并在 amux.notes 中说明，不会替你猜一个。

产物#

data[].url 与 amux.images[].url 都指向我们转存的那一份，不是上游的临时地址。

存储产物会被清理——需要长期保存请尽快下载，到期之后地址返回 404。

不支持的参数#

传了不会报错，会被丢弃并在 amux.notes 里说明——所以拿到图之后如果效果不对， 先看一眼 notes。

⚠️ style 是例外：它被丢弃时不会出现在 amux.notes 里。 上表其余参数都在这个模型的参数矩阵里标着「不支持」，所以丢弃时有据可报； 而 style 不是站内建模过的参数，请求解析时就不会保留它。 换句话说，传了 style 没有任何反馈，请按它不存在来写代码。

错误#

错误体形状与 OpenAI 一致，type 取值与重试语义见错误与重试。

curl https://gateway.amux.ai/v1/images/generations \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -d '{
    "model": "x-ai/grok-imagine-image-2.0",
    "prompt": "A red fox sitting in snow, photorealistic",
    "aspect_ratio": "16:9",
    "image_size": "1K"
  }'

{
  "created": 1786000000,
  "data": [
    {
      "url": "<string>"
    }
  ],
  "usage": {
    "output_images": 0,
    "input_images": 0
  },
  "amux": {
    "task_id": "<string>",
    "generation_id": "<string>",
    "provider": "<string>",
    "cost_nano": "<string>",
    "images": [
      {
        "index": 0,
        "url": "<string>"
      }
    ],
    "notes": [
      "<string>"
    ]
  }
}