Create image edit

x-ai/grok-imagine-image-quality 的图生图。请求体是 multipart/form-data：参考图当文件传， 其余参数当普通字段。

这个模型不支持流式，也不支持蒙版。

鉴权

header

Authorizationstring必填

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

请求

multipart/form-data

modelstring必填

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

promptstring必填

想怎么改。

imagearray<string>必填

参考图，必填。image 与 image[] 两种字段名均支持——OpenAI SDK 通常在单图场景使用前者，多图场景使用后者。

最多 3 张、单张 25 MiB，且编码后的总大小不超过 48 MB。超出会返回 400，不会静默丢图。

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 发出——档位会显式写进上游请求，不依赖上游默认值。

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

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

userstring

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

响应

200response

改图成功。形状与生成端点一致。

400response

请求不合法：参考图张数或体积超限、使用了 URL 形式的参考图，或用了这个模型不支持的能力。

402response

可用余额不足以覆盖预扣上界。

503response

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

参考图#

字段名 image 或 image[] 都收（官方 SDK 单图发前者、多图发后者）。参考图必填。

三条限制，任何一条超了都返回 400，不会静默丢图：

1. 最多 3 张——这是上游对这个模型的硬限制；
2. 单张不超过 25 MiB；
3. 编码后总大小不超过 48 MB。

参考图按张计入成本，与出图张数（n）无关：出两张图、给一张参考图， 参考图仍然只算一张。

⚠️ 不支持蒙版（mask），上游的编辑端点没有这个概念。传了会被丢弃并在 amux.notes 中说明。

⚠️ 参考图必须以文件形式上传，不支持传 URL。

尺寸与格式#

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

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

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

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

比例#

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

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

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

quality 不被支持#

上游接受这个参数，但在这个模型上它既不改变产物的分辨率，也不改变计费档位。 所以站内把它标记为不支持：传了会被丢弃，并在 amux.notes 中说明。

这个模型的计费档位只由 image_size 决定。

产物#

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

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

不支持的参数#

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

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

异步也能改图#

同一批参数发到 /v1/tasks（同样用 multipart）即可走异步编辑。

错误#

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

curl https://gateway.amux.ai/v1/images/edits \
  -H "Authorization: Bearer $AMUX_API_KEY" \
  -F "model=x-ai/grok-imagine-image-quality" \
  -F "prompt=<string>" \
  -F "image=@/path/to/image.png" \
  -F "n=1" \
  -F "aspect_ratio=1:1" \
  -F "image_size=1K" \
  -F "moderation=auto" \
  -F "user=<string>"

{
  "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>"
    ]
  }
}