Qwen-Image-Max API

通義萬相文生圖最高品質版, $0.075/張, 適合商業廣告 / 高階創作.

POST /v1/images/generations

qwen-image-max:影像生成,含必填項、巢狀響應和虛構示例。

基础调用

必填参数: model, input

可用参数: model, input, parameters

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: qwen-image-max
inputobject是输入消息对象。
parametersobject否可选图像参数。
## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ## 参考 参数术语参考[Qwen Image官方说明](https://docs.modelstudio.console.alibabacloud.com/en/model-studio/qwen-image-api-reference);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:qwen-image-max | | `input` | object | 是 | 输入消息对象。 | | `input.messages` | array[object] | 是 | 单条 user 消息。 | | `input.messages[].role` | string | 是 | 固定 user。 可选值:user | | `input.messages[].content` | array[object] | 是 | 文本与参考图内容块。 | | `input.messages[].content[].text` | string | 否 | 生成描述或编辑指令;至少一个文本块。 | | `input.messages[].content[].image` | string | 否 | 编辑时提供可访问的参考图URL,每块一张。 | | `parameters` | object | 否 | 可选图像参数。 | | `parameters.n` | integer | 否 | 生成张数;示例仅生成一张。 默认:1; 最小值:1 | | `parameters.size` | string | 否 | 宽*高格式,例如1024*1024;可用范围按型号。 | | `parameters.seed` | integer | 否 | 可选随机种子,不承诺逐像素相同。 | | `parameters.watermark` | boolean | 否 | 是否添加水印。 | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `request_id` | string | 否 | 响应请求标识。 | | `output` | object | 否 | 图像输出;读取实际存在的choices或results。 | | `output.choices` | array[object] | 否 | 部分型号的图像结果。 | | `output.choices[].message` | object | 否 | 图像输出消息。 | | `output.choices[].message.role` | string | 否 | 消息角色。 | | `output.choices[].message.content` | array[object] | 否 | 结果内容块。 | | `output.choices[].message.content[].image` | string | 否 | 生成图像URL。 | | `output.choices[].message.content[].text` | string | 否 | 附加文本。 | | `output.results` | array[object] | 否 | 部分型号返回的图像列表。 | | `output.results[].url` | string | 否 | 生成图像URL。 | | `output.task_status` | string | 否 | 返回时的任务状态(如果提供)。 | | `usage` | object | 否 | 模型返回的图像用量。 | | `usage.image_count` | integer | 否 | 返回的图像数。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request POST https://api.router.ai/v1/images/generations \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "qwen-image-max",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "A fictional blue paper boat on a plain white background."
          }
        ]
      }
    ]
  },
  "parameters": {
    "n": 1
  }
}'

接口通用说明: Aliyun Qwen-Image 文生圖