xAI 出品的图片生成模型,支持文生图与图片编辑。
Authorization: Bearer YOUR_API_KEY| 模型 | model | 价格 | 说明 |
|---|---|---|---|
| Grok Imagine Image | grok-imagine/grok-imagine-image | $0.03/张 | xAI Grok Imagine,文生图与图生图(~4s) |
| Grok Imagine Image Pro | grok-imagine-pro/grok-imagine-image-pro | $0.0800-$0.1200/张 | 高精度细节,原生 1K/2K(默认 2K),文生图与多图编辑(最多 3 张参考图,不额外收费) |
| Grok 4.2 Image | grok-4.2-image | $0.03/张 | 已并入 grok-imagine-image(同价,旧名仍可用) |
# Step 1: Create task (text-to-image)
curl -X POST https://apimodels.app/api/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine/grok-imagine-image",
"prompt": "A cute cat wearing a space helmet, digital art",
"aspect_ratio": "1:1",
"n": 1
}'
# Image editing (one reference image; aspect_ratio is ignored here)
curl -X POST https://apimodels.app/api/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine/grok-imagine-image",
"prompt": "Replace the cat with a golden retriever",
"image_url": "https://example.com/cat.png"
}'
# Multi-image editing (up to 3 references, Pro only)
curl -X POST https://apimodels.app/api/v1/images/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-imagine-pro/grok-imagine-image-pro",
"prompt": "Put the dog from <IMAGE_1> into the room from <IMAGE_0>",
"image_urls": ["https://example.com/room.png", "https://example.com/dog.png"],
"resolution": "2k"
}'
# Step 2: Poll status
curl "https://apimodels.app/api/v1/images/generations?task_id=TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"| 字段 | 必填 | 类型 | 说明 |
|---|---|---|---|
| model | 是 | string | grok-imagine/grok-imagine-image / grok-imagine-pro/grok-imagine-image-pro(grok-4.2-image = grok-imagine-image 的别名) |
| prompt | 是 | string | 图片描述或编辑指令 |
| image_url | 否 | string | 参考图片 URL 或 base64,用于图片编辑 |
| image_urls | 否 | string[] | 仅 grok-imagine-pro:多张参考图(最多 3 张,不额外收费——价格只按 resolution 分档)。在 prompt 里用 <IMAGE_0>、<IMAGE_1> 引用。超过 3 张会直接报错,不会静默丢弃。 |
| image_base64 | 否 | string | Base64 编码的参考图,用于图片编辑 |
| resolution | 否 | string | 仅 grok-imagine-pro:1k 或 2k(默认 2k)。分档计价:1k $0.08、2k $0.12。 |
| aspect_ratio | 否 | string | grok-imagine 与 grok-imagine-pro:1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20, auto(默认 1:1,传 image 时被忽略) |
| n | 否 | integer | 生成数量:1-10(默认 1;grok-imagine 与 grok-imagine-pro 仅支持 1) |
| callback_url | 否 | string | 任务完成后的回调 URL |
试一试:Playground
grok-imagine-image $0.03/张(文生图与图生图,约 4 秒);grok-imagine-image-pro 按分辨率分档:1K $0.08、2K $0.12,最多 3 张参考图不加价。
不听 —— 传了参考图后 aspect_ratio 被忽略,输出跟随输入图比例。