图片生成（grok-imagine-image-2.0）

根据提示词生成图片。grok-imagine-image-2.0 是 xAI 的新一代图像模型，支持 1k/ 1.5k / 2k 三档分辨率、16 种画面比例和 quality 质量档位，中英文文字渲染稳定。

官方文档：https://docs.x.ai/developers/model-capabilities/images/generation

⚠️ 注意事项

请求体为 application/json。尺寸用 aspect_ratio + resolution 控制：resolution 只认档位 1k / 1.5k / 2k。

兼容 OpenAI 的 size 字段（如 1024x1024），会自动换算成档位和比例；新代码建议直接用 aspect_ratio + resolution。

默认返回的 url 是临时地址，请尽快下载转存；需要直接拿图片数据请用 response_format: "b64_json"。

出图通常 10 - 25 秒，quality: "medium" 要 60 - 90 秒，客户端超时建议 ≥ 120 秒。出图请求成本高，只对网络类错误重试。

内容被审核拦截时返回 imagine:content-moderated，请调整提示词后重试。

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

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

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

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

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

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

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

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

否则接口会拒绝请求

🎯 关键提示

resolution × aspect_ratio 实测输出尺寸：

1k：1:1 → 1024×1024，16:9 → 1280×720，9:16 → 720×1280，3:2 → 1248×832，3:4 → 864×1152

1.5k：1:1 → 1408×1408

2k：1:1 → 2048×2048，16:9 → 2816×1584

2k 返回 PNG（约 7 MB），1k / 1.5k 返回 JPEG（约 150 KB）

aspect_ratio 默认 auto，由模型根据提示词决定（不一定是方图）；需要固定比例请显式传。可选值：1:1、16:9/ 9:16、4:3 / 3:4、3:2 / 2:3、2:1 / 1:2、20:9/ 9:20、21:9、5:2。

quality 支持 auto / low / medium：

auto（默认）：文生图时等同 low

low：约 10 - 15 秒，日常 / 批量档

medium：细节更多，更慢（约 60 - 90 秒），价格更高

传 high 会报 400

n 支持 1 - 10，按张计费；想批量出图优先用 n。

响应里的 usage.cost_in_usd_ticks 是本次请求成本（1 美分 = 1 亿 ticks），仅供参考，实际扣费以平台账单为准。

计费方式：按生成的张数收费，n 填几就收几张的钱。不同质量价格不一样，medium 比 low 贵，默认的 auto 按 low 收费。

请求参数

Header 参数

Body 参数application/json必填

示例

方图 1k横版 2k文字海报 · 多张 · base64

{
    "model": "grok-imagine-image-2.0",
    "prompt": "一只戴着宇航头盔的柴犬，扁平插画风格，纯色背景",
    "n": 1,
    "aspect_ratio": "1:1",
    "resolution": "1k"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

成功（url）成功（b64_json，n=2）

{
    "data": [
        {
            "url": "https://imgen.x.ai/xai-imgen/xai-tmp-imgen-e0a9a3c4-1636-91ea-9c03-10ad4d5a8f42.jpeg",
            "mime_type": "image/jpeg"
        }
    ],
    "usage": {
        "cost_in_usd_ticks": 400000000
    }
}

🟠400参数错误

🟠422字段格式错误

图片生成（grok-imagine-image-2.0）

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

请求参数

请求示例代码

返回响应

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