Grok Imagine 2.0 - AIMax

模型名称：grok-imagine-2.0

面向创意文生图、电影感画面与视觉概念探索
对外使用统一图片异步任务协议，提交成功后返回 task_id
仅支持文生图，不支持参考图编辑
支持单次生成 1..12 张，结果请按 works[] 完整读取

请求鉴权

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/images/generations

请求参数

字段	类型	默认值	说明
`model`（必填）	`string`	-	固定传 `grok-imagine-2.0`
`prompt`（必填）	`string`	-	图片生成提示词
`n`	`number`	`1`	生成数量，支持 `1..12`
`size`	`string`	`1:1`	支持比例或固定像素尺寸
`resolution`	`string`	-	可省略；传入时仅支持 `quality`

说明：

size 比例支持 1:1、2:3、3:2、3:4、4:3、9:16、16:9。
固定像素尺寸支持：1024x1024、1024x1792、1792x1024、720x1280、1280x720。
不支持 images、stream、quality、style 和自定义任意像素尺寸。
生成结果始终通过任务查询的 works[].asset_url 返回，不能通过请求参数改为同步或内嵌图片结果。

响应

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE_GROK_IMAGINE_20",
    "status": "submitted",
    "model": "grok-imagine-2.0"
  }
}

任务查询接口

GET /v1/tasks/{task_id}

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE_GROK_IMAGINE_20",
    "status": "succeeded",
    "works": [
      { "asset_url": "https://example.com/result/grok-imagine-20-01.jpg" },
      { "asset_url": "https://example.com/result/grok-imagine-20-02.jpg" }
    ]
  }
}

code 是数字 200；提交后的处理状态和失败状态请按异步任务查询轮询处理。

使用示例

curl --request POST \
  --url https://api.aimaxa.cn/v1/images/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "grok-imagine-2.0",
    "prompt": "一座雨后霓虹未来城市的电影级广角画面，街道倒影、轻雾、人物剪影、强烈的蓝紫色光影",
    "n": 2,
    "size": "16:9",
    "resolution": "quality"
  }'