Qwen Image 3.0 Pro

图片生成模型,支持文生图和参考图编辑。每个任务仅生成一张图片;完成后返回临时图片链接,平台不转存。

<details>
<summary>基本信息</summary>

字段内容
类型模型 API
模型名称Qwen Image 3.0 Pro
模型编码qwen-image-3.0-pro
模型类型图片生成(image)
调用方式POST /api/v1/tasks
调用模式异步
最大参考图片数3

</details>

鉴权

所有调用必须在请求头携带平台分配的 API Key:

Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

请求路径

POST /api/v1/tasks

该模型为异步任务。提交后返回平台 task_id,通过 GET /api/v1/tasks/{task_id} 查询结果;也可传入 callback_url 接收平台终态回调。

业务参数

参数类型必填默认值可选值 / 范围示例说明
modelstring是—qwen-image-3.0-pro—模型编码。
channelstring否—dashscope_compatible—指定渠道;不传时按当前租户可用路由选择。
input.messagesarray是—仅 1 条消息—消息数组,仅支持一条 role=user 的消息。
input.messages[0].contentarray是—1 个文本项,附加 0 至 3 个图片项—文生图只传文本项;参考图编辑传一个文本项和 1 至 3 个图片项。
parameters.ninteger是—11每个任务生成图片数,固定为 1。
parameters.sizestring否服务自动选择总像素范围 512*512 至 2048*2048;比例 1:8 至 8:11024*1024输出尺寸,格式为 宽*高。
parameters.prompt_extendboolean否truetrue / falsetrue是否启用提示词优化。
parameters.prompt_extend_modestring否directdirect / agentdirect参考图编辑仅支持 direct。
parameters.negative_promptstring否——模糊,低质量反向提示词。
parameters.seedinteger否—0 至 214748364712345随机种子。
parameters.watermarkboolean否falsetrue / falsefalse是否添加水印。
callback_urlstring否—HTTPS URLhttps://example.com/hook任务进入终态时的平台回调地址。

参考图使用 {"image": "<图片 URL 或 data:image Base64>"}。支持 JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF 格式;公网 URL 在任务执行期间必须可访问。

请求示例

文生图

{
  "model": "qwen-image-3.0-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"text": "窗边的橘猫,清晨阳光,写实摄影,温暖自然色调"}
        ]
      }
    ]
  },
  "parameters": {
    "n": 1,
    "size": "1024*1024",
    "prompt_extend": true,
    "watermark": false
  }
}

参考图编辑

{
  "model": "qwen-image-3.0-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {"image": "https://example.com/reference.png"},
          {"text": "保留主体轮廓,改成雨后霓虹街景的电影海报风格"}
        ]
      }
    ]
  },
  "parameters": {
    "n": 1,
    "size": "1024*1536",
    "prompt_extend_mode": "direct",
    "watermark": false
  },
  "callback_url": "https://example.com/hook"
}

成功响应

{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxx",
    "status": "pending",
    "model": "qwen-image-3.0-pro",
    "created_at": "2026-08-12T12:00:00Z"
  }
}

查询任务结果

GET /api/v1/tasks/{task_id}
{
  "code": 1,
  "msg": "success",
  "data": {
    "task_id": "task_xxxxxxxxxxxx",
    "status": "completed",
    "result": {
      "results": [
        {"url": "https://example.com/result.png", "type": "image"}
      ]
    },
    "usage": {
      "output_width": 1024,
      "output_height": 1024,
      "output_image_count": 1
    },
    "completed_at": "2026-08-12T12:00:30Z"
  }
}

result.results[].url 是临时图片链接,有效期约 24 小时。平台不转存,也不提供永久保存,请及时下载或保存。

失败响应

{
  "code": 0,
  "msg": "请求参数不合法",
  "data": null
}

错误说明

场景说明
参数校验失败input.messages 不是单条用户消息、文本项数量不为 1、参考图超过 3 张、n 不为 1,或尺寸、种子不在支持范围内。
参考图编辑限制传入参考图时,prompt_extend_mode 不能为 agent。
任务失败查询结果 status=failed,msg 返回安全的失败说明。
权限或余额不足请检查 API Key 权限、当前模型上架状态和账户余额。

价格查询

调用前请通过 GET /api/v1/pricing?type=model&model=qwen-image-3.0-pro 查询有效价格。实际扣费以任务创建时的价格快照为准。

同类文章