图片编辑（grok-imagine-image-2.0）

基于 1 - 5 张参考图 + 提示词生成编辑后的图片，适合背景替换、风格迁移、局部修改和多图融合。

官方文档：https://docs.x.ai/developers/model-capabilities/images/editing
多图编辑：https://docs.x.ai/developers/model-capabilities/images/multi-image-editing

⚠️ 注意事项

请求体为 application/json，不是 multipart/form-data。不要用 OpenAI SDK 的 client.images.edit()（它发 multipart），否则会返回 当前分组 xxx 下对于模型 dall-e-2 无可用渠道 报错。

image（单图）和 images（多图）二选一，同时传会报 400。

image 必须是对象 {"url": "..."}。

images 最多 5 张，传 6 张会报 400。

源图格式为 JPEG / PNG / WebP（GIF 会报 invalid_image）。可以是公网 URL，也可以是 base64 data URI（data:image/png;base64,...）；公网 URL 必须能直接下载，否则报 Failed to download the provided image。

局部修改直接在 prompt 里描述要改的区域即可（例如"把头盔改成红色"），无需蒙版。

默认返回的 url 是临时地址，请尽快下载转存。

改图比文生图贵：默认按 medium 质量收费，每张参考图也要收费，详见下方「计费方式」。

请避免生成以下类型内容：

未成年人相关不当内容，包括色情、性暴力、非自愿亲密内容、明显以性满足为目的的成人内容

血腥暴力、恐怖主义、极端主义、武器制作、违法或危险行为

自伤、自杀、进食障碍、危险挑战等可能造成现实伤害的内容

仇恨、骚扰、威胁、欺凌、诽谤或针对受保护群体的攻击

未授权真人肖像、名人肖像/公众人物、证件照、监控照或可能混淆真实性的人像内容

隐私信息、敏感个人信息、金融/医疗/法律等可能影响个人权益的内容

版权角色、品牌 Logo、水印移除、CAPTCHA或规避平台安全审核的请求

否则接口会拒绝请求

🎯 关键提示

多图时在 prompt 里用 <IMAGE_0>、<IMAGE_1>…… 按 images 数组顺序指代各张图，例如：让 <IMAGE_0> 里的柴犬穿上 <IMAGE_1> 的卫衣。

aspect_ratio：不传时单图沿用源图比例；多图时模型可能自行决定。显式指定比例时，模型会按新比例重新构图，不会拉伸原图。

quality 支持 auto / low / medium：

auto（默认）：改图时等同 medium

low：更快（实测约 9 秒，medium 约 14 秒）也更便宜，背景替换类效果差别不大，批量改图建议显式传 low

resolution：1k（默认）/ 1.5k / 2k，2k 返回 PNG。

n 支持 1 - 10，一次返回多张不同的结果。

同一个 images 数组里可以混用公网 URL 和 base64 data URI。

计费方式：除了生成出来的图要收费，上传的每张参考图也会单独收费，参考图越多越贵（n 填多少，参考图都只收一次）。不同质量价格也不一样：改图默认按 medium 收费，传 quality: "low" 会便宜一些。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "data": [
        {
            "url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-7c1d52e8-0b3a-4f61-a2c9-5e8f3d9b1a07.jpeg",
            "mime_type": "image/jpeg"
        }
    ],
    "usage": {
        "cost_in_usd_ticks": 700000000
    }
}

🟠400参数错误

🟠422字段格式错误

🔴503无可用渠道

图片编辑（grok-imagine-image-2.0）

请避免生成以下类型内容：#

请求参数

请求示例代码

返回响应

请避免生成以下类型内容：