Qwen Image 3.0 Pro - AIMax

模型名称：qwen-image-3.0-pro

面向复杂中文排版、品牌物料、精细文字和多参考图创作
对外使用统一图片异步任务协议，提交成功后返回 task_id
支持文生图与参考图图生图，参考图使用 images
支持单次生成 1..6 张，结果按 works[] 的顺序读取

请求鉴权

Authorization: Bearer YOUR_API_KEY

提交任务接口

POST /v1/images/generations

请求参数

字段	类型	默认值	说明
`model`（必填）	`string`	-	固定传 `qwen-image-3.0-pro`
`prompt`（必填）	`string`	-	图片生成提示词
`n`	`number`	`1`	生成数量，支持 `1..6`
`size`	`string`	`1:1`	图片比例或精确像素尺寸
`resolution`	`string`	`1k`	支持 `1k`、`2k`
`images`	`string[]`	-	参考图地址数组，最多 `3` 张
`negative_prompt`	`string`	-	负向提示词
`prompt_extend`	`boolean`	-	是否启用提示词扩展
`prompt_extend_mode`	`string`	-	`direct` 或 `agent`

说明：

比例尺寸支持 1:1、4:3、3:4、16:9、9:16、3:2、2:3。
精确像素尺寸支持 宽x高：宽、高均为 512..2048，宽高比处于 1:8..8:1。
agent 扩展模式要求 prompt_extend=true，且只可用于文生图。
images 是输入参考图；生成完成后请从 works[].asset_url 读取全部输出作品。

响应

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE_QWEN_IMAGE_30_PRO",
    "status": "submitted",
    "model": "qwen-image-3.0-pro"
  }
}

任务查询接口

GET /v1/tasks/{task_id}

{
  "code": 200,
  "data": {
    "task_id": "task_01KQEXAMPLE_QWEN_IMAGE_30_PRO",
    "status": "succeeded",
    "works": [
      { "asset_url": "https://example.com/result/qwen-image-30-pro-01.png" }
    ]
  }
}

所有状态查询都以数字 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": "qwen-image-3.0-pro",
    "prompt": "设计一张高端咖啡品牌新品发布海报：中文标题清晰，包含产品、价格区和留白区域，画面有杂志版式感",
    "size": "4:3",
    "resolution": "2k",
    "n": 1
  }'