主题模式
阿里云百炼图像生成 API 文档
各模型支持的参数
Qwen-Image-Plus 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 文本提示词 | 支持中英文，长度不超过 800 个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断 |
negative_prompt | string | 否 | 反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制 | 支持中英文，长度不超过 500 个字符，超出部分将自动截断 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
size | string | 否 | 输出图像的分辨率，格式为 宽*高 | 1328*1328 | 可选的分辨率及其对应的图像宽高比例为：1664*928 (16:9), 1472*1140 (4:3), 1328*1328 (1:1, 默认值), 1140*1472 (3:4), 928*1664 (9:16) |
image_size | string | 否 | 图片尺寸的别名（映射到 size） | - | 格式：宽x高（如 1328x1328）或 宽*高，会自动转换为 宽*高 格式 |
n | integer | 否 | 生成图像的数量 | 1 | 此参数当前固定为 1，设置其他值将导致报错 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 此参数当前固定为 1，设置其他值将导致报错 |
prompt_extend | bool | 否 | 是否开启 prompt 智能改写。开启后，将使用大模型优化正向提示词，对描述性不足、较为简单的 prompt 有明显提升效果，但会增加 3-4 秒耗时 | true | true（默认值，开启智能改写）或 false（不开启智能改写） |
watermark | bool | 否 | 是否在图像右下角添加 "Qwen-Image" 水印 | false | true 或 false（默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围 [0, 2147483647]。使用相同的 seed 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
json
{
"model": "Qwen-Image-Plus",
"input": {
"prompt": "一只坐着的橘黄色的猫，表情愉悦，活泼可爱，逼真准确",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1328*1328",
"prompt_extend": true,
"watermark": false,
"seed": 12345
}
}Qwen-Image 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 文本提示词 | 支持中英文，长度不超过 800 个字符，每个汉字、字母、数字或符号计为一个字符，超过部分会自动截断 |
negative_prompt | string | 否 | 反向提示词，用于描述不希望在图像中出现的内容，对画面进行限制 | 支持中英文，长度不超过 500 个字符，超出部分将自动截断 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
size | string | 否 | 输出图像的分辨率，格式为 宽*高 | 1328*1328 | 可选的分辨率及其对应的图像宽高比例为：1664*928 (16:9), 1472*1140 (4:3), 1328*1328 (1:1, 默认值), 1140*1472 (3:4), 928*1664 (9:16) |
image_size | string | 否 | 图片尺寸的别名（映射到 size） | - | 格式：宽x高（如 1328x1328）或 宽*高，会自动转换为 宽*高 格式 |
n | integer | 否 | 生成图像的数量 | 1 | 此参数当前固定为 1，设置其他值将导致报错 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 此参数当前固定为 1，设置其他值将导致报错 |
prompt_extend | bool | 否 | 是否开启 prompt 智能改写。开启后，将使用大模型优化正向提示词，对描述性不足、较为简单的 prompt 有明显提升效果，但会增加 3-4 秒耗时 | true | true（默认值，开启智能改写）或 false（不开启智能改写） |
watermark | bool | 否 | 是否在图像右下角添加 "Qwen-Image" 水印 | false | true 或 false（默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围 [0, 2147483647]。使用相同的 seed 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
json
{
"model": "Qwen-Image",
"input": {
"prompt": "一只坐着的橘黄色的猫，表情愉悦，活泼可爱，逼真准确",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1328*1328",
"prompt_extend": true,
"watermark": false,
"seed": 12345
}
}Qwen-Image-Edit-Plus 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 图像编辑指令，即正向提示词，用来描述生成图像中期望包含的元素和视觉特点 | 支持中英文，长度上限 800 个字符，每个汉字/字母占一个字符，超过部分会自动截断。进行多图像编辑时，编辑指令中需要使用"图1"、"图2"、"图3"等描述来指代相应的图片 |
image | string/array | 是 | 输入图像的 URL 或 Base64 编码数据。支持传入 1-3 张图像，当传入多张图像时，输出图像的比例以最后一张为准。支持字符串格式（单张图像）或数组格式（多张图像） | 支持 URL（http:// 或 https://）或 Base64 编码（带 data:image/{format};base64, 前缀或不带前缀，支持 PNG、JPEG、JPG 等格式）。图像要求：格式为 JPG、JPEG、PNG、BMP、TIFF、WEBP；图像分辨率：宽度和高度均需在 384-3072 像素范围内；图像大小：不超过 10 MB。数组格式示例：["url1", "url2", "url3"] 或 ["base64_1", "base64_2", "base64_3"] |
image2 | string | 否 | 第二张参考图像（多图融合时使用） | 同 image 参数要求 |
image3 | string | 否 | 第三张参考图像（多图融合时使用） | 同 image 参数要求 |
negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制 | 支持中英文，长度上限 500 个字符，每个汉字/字母占一个字符，超过部分会自动截断 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
size | string | 否 | 设置输出图像的分辨率，格式为 宽*高 | - | 宽和高的取值范围均为 [512, 2048] 像素。使用限制：该参数仅在输出图像数量 n 为 1 时可用，否则将报错。若不设置，输出图像将保持与原图相似的长宽比，接近 1024*1024 分辨率 |
image_size | string | 否 | 图片尺寸的别名（映射到 size） | - | 格式：宽x高（如 1024x2048）或 宽*高，会自动转换为 宽*高 格式。使用限制：该参数仅在输出图像数量 n 为 1 时可用 |
n | integer | 否 | 输出图像的数量 | 1 | 可选择输出 1-6 张图片 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 可选择输出 1-6 张图片 |
prompt_extend | bool | 否 | 是否开启 prompt 智能改写。开启后，将使用大模型优化正向提示词，对描述性不足、较为简单的 prompt 提升效果较明显 | true | true（默认值，开启智能改写）或 false（不开启智能改写） |
watermark | bool | 否 | 是否在图像右下角添加 "Qwen-Image" 水印 | false | true 或 false（默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围 [0, 2147483647]。使用相同的 seed 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
单图编辑请求：
json
{
"model": "Qwen-Image-Edit-Plus",
"input": {
"prompt": "生成一张符合深度图的图像，遵循以下描述：一辆红色的破旧的自行车停在一条泥泞的小路上，背景是茂密的原始森林",
"image": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250925/fpakfo/image36.webp",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1024*1024",
"n": 1,
"prompt_extend": true,
"watermark": false,
"seed": 12345
}
}多图融合请求：
json
{
"model": "Qwen-Image-Edit-Plus",
"input": {
"prompt": "图1中的女生穿着图2中的黑色裙子按图3的姿势坐下，保持其服装、发型和表情不变，动作自然流畅",
"image": "data:image/jpeg;base64,GDU7MtCZz...",
"image2": "data:image/jpeg;base64,ABC123...",
"image3": "data:image/jpeg;base64,XYZ789...",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"n": 2,
"prompt_extend": true,
"watermark": false,
"seed": 12345
}
}Qwen-Image-Edit 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 图像编辑指令，即正向提示词，用来描述生成图像中期望包含的元素和视觉特点 | 支持中英文，长度上限 800 个字符，每个汉字/字母占一个字符，超过部分会自动截断。进行多图像编辑时，编辑指令中需要使用"图1"、"图2"、"图3"等描述来指代相应的图片 |
image | string/array | 是 | 输入图像的 URL 或 Base64 编码数据。支持传入 1-3 张图像，当传入多张图像时，输出图像的比例以最后一张为准。支持字符串格式（单张图像）或数组格式（多张图像） | 支持 URL（http:// 或 https://）或 Base64 编码（带 data:image/{format};base64, 前缀或不带前缀，支持 PNG、JPEG、JPG 等格式）。图像要求：格式为 JPG、JPEG、PNG、BMP、TIFF、WEBP；图像分辨率：宽度和高度均需在 384-3072 像素范围内；图像大小：不超过 10 MB。数组格式示例：["url1", "url2", "url3"] 或 ["base64_1", "base64_2", "base64_3"] |
image2 | string | 否 | 第二张参考图像（多图融合时使用） | 同 image 参数要求 |
image3 | string | 否 | 第三张参考图像（多图融合时使用） | 同 image 参数要求 |
negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制 | 支持中英文，长度上限 500 个字符，每个汉字/字母占一个字符，超过部分会自动截断 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
n | integer | 否 | 输出图像的数量 | 1 | 仅支持输出 1 张图片，设置其他值将导致报错 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 仅支持输出 1 张图片，设置其他值将导致报错 |
watermark | bool | 否 | 是否在图像右下角添加 "Qwen-Image" 水印 | false | true 或 false（默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围 [0, 2147483647]。使用相同的 seed 参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。注意：模型生成过程具有概率性，即使使用相同的 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
json
{
"model": "Qwen-Image-Edit",
"input": {
"prompt": "让天空更加多彩",
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"watermark": false,
"seed": 12345
}
}Wan2.5-T2I-Preview 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 正向提示词，用来描述生成图像中期望包含的元素和视觉特点 | 支持中英文，每个汉字/字母占一个字符，超过部分会自动截断。长度不超过 2000 个字符。示例值：一只坐着的橘黄色的猫，表情愉悦，活泼可爱，逼真准确 |
negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制 | 支持中英文，长度不超过 500 个字符，超过部分会自动截断。示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
size | string | 否 | 输出图像的分辨率，格式为 宽*高 | 1280*1280 | 总像素在 [768*768, 1440*1440] 之间且宽高比范围为 [1:4, 4:1]。例如，768*2700 符合要求。常见比例推荐分辨率：1280*1280 (1:1), 1024*1024 (1:1), 800*1200 (2:3), 1200*800 (3:2), 960*1280 (3:4), 1280*960 (4:3), 720*1280 (9:16), 1280*720 (16:9), 1344*576 (21:9) |
image_size | string | 否 | 图片尺寸的别名（映射到 size） | - | 格式：宽x高（如 1280x1280）或 宽*高，会自动转换为 宽*高 格式 |
n | integer | 否 | 生成图片的数量。注意：n 直接影响费用。费用 = 单价 × 图片张数，请在调用前确认模型价格 | 1 | 取值范围为 1~4 张。测试阶段建议设置为 1，便于低成本验证 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 取值范围为 1~4 张 |
prompt_extend | bool | 否 | 是否开启 prompt 智能改写。开启后使用大模型对输入 prompt 进行智能改写。对于较短的 prompt 生成效果提升明显，但会增加耗时 | false | true（开启智能改写）或 false（不开启智能改写，默认值） |
watermark | bool | 否 | 是否添加水印标识，水印位于图片右下角，文案固定为"AI 生成" | false | true（添加水印）或 false（不添加水印，默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围是 [0, 2147483647]。如果不提供，则算法自动生成一个随机数作为种子。如果提供，则根据 n 的值分别为 n 张图片生成 seed 参数，例如 n=4，算法将分别生成 seed、seed+1、seed+2、seed+3 作为参数的图片。若需提升生成结果的可复现性，建议固定 seed 值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
文生图请求：
json
{
"model": "Wan2.5-T2I-Preview",
"input": {
"prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1024*1024",
"n": 1,
"prompt_extend": false,
"watermark": false,
"seed": 12345
}
}文生图请求（使用反向提示词）：
json
{
"model": "Wan2.5-T2I-Preview",
"input": {
"prompt": "一间有着精致窗户的花店，漂亮的木质门，摆放着花朵",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1280*1280",
"n": 4,
"prompt_extend": false,
"watermark": false,
"seed": 12345
}
}Wan2.5-I2I-Preview 模型
Input 参数
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
prompt | string | 是 | 正向提示词，用来描述生成图像中期望包含的元素和视觉特点 | 支持中英文，每个汉字/字母占一个字符，超过部分会自动截断。长度不超过 2000 个字符。示例值：将花卉连衣裙换成一件复古风格的蕾丝长裙，领口和袖口有精致的刺绣细节 |
image | string/array | 是 | 输入图像的 URL 或 Base64 编码数据。支持传入 1-3 张图像，多图输入时，按照数组顺序定义图像顺序。支持字符串格式（单张图像）或数组格式（多张图像） | 支持 URL（http:// 或 https://）或 Base64 编码（带 data:image/{format};base64, 前缀或不带前缀，支持 PNG、JPEG、JPG 等格式）。图像要求：格式为 JPEG、JPG、PNG（不支持透明通道）、BMP、WEBP；图像分辨率：图像的宽高范围均为 [384, 5000] 像素；图像大小：不超过 10 MB。数组格式示例：["url1", "url2", "url3"] 或 ["base64_1", "base64_2", "base64_3"] |
image2 | string | 否 | 第二张参考图像（多参考图生图时使用） | 同 image 参数要求 |
image3 | string | 否 | 第三张参考图像（多参考图生图时使用） | 同 image 参数要求 |
negative_prompt | string | 否 | 反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制 | 支持中英文，长度不超过 500 个字符，超过部分会自动截断。示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等 |
ExtraBody 参数
| 参数名 | 类型 | 必填 | 说明 | 默认值 | 取值范围/格式 |
|---|---|---|---|---|---|
size | string | 否 | 设置输出图像的分辨率，格式为 宽*高 | 1280*1280 | 图像分辨率：总像素在 [768*768, 1280*1280] 之间，且宽高比范围为 [1:4, 4:1] |
image_size | string | 否 | 图片尺寸的别名（映射到 size） | - | 格式：宽x高（如 1280x1280）或 宽*高，会自动转换为 宽*高 格式 |
n | integer | 否 | 生成图片的数量。注意：n 直接影响费用。n 越大费用越高，请在调用前确认模型价格 | 1 | 取值范围为 1~4 张。测试阶段建议设置为 1 |
batch_size | integer | 否 | 生成图像数量的别名（映射到 n） | - | 取值范围为 1~4 张 |
watermark | bool | 否 | 是否添加水印标识，水印位于图片右下角，文案固定为"AI 生成" | false | true（添加水印）或 false（不添加水印，默认值） |
seed | integer | 否 | 随机数种子 | - | 取值范围是 [0, 2147483647]。如果不提供，则算法自动生成一个随机数作为种子。如果提供，则根据 n 的值分别为 n 张图片生成 seed 参数，例如 n=4，算法将分别生成 seed、seed+1、seed+2、seed+3 作为参数的图片。若需提升生成结果的可复现性，建议固定 seed 值。请注意，由于模型生成具有概率性，即使使用相同 seed，也不能保证每次生成结果完全一致 |
provider | object | 否 | 调度配置参数 | - | 对象类型，包含图像生成特有参数和供应商调度参数。 图像生成特有参数： - enable_image_base64 (bool, 默认 false): 是否在响应数据的 data 字段中同时返回图像的 Base64 编码- enable_image_origin_data (bool, 默认 false): 是否在响应中包含原始响应数据供应商调度参数：还支持 only、order、sort、input_price_range、output_price_range、throughput_range、latency_range、input_length_range、allow_filter_prompt_length、ignore、allow_fallbacks 等参数。详细说明请参考：供应商调度参数说明 |
请求示例
单图编辑请求：
json
{
"model": "Wan2.5-I2I-Preview",
"input": {
"prompt": "将花卉连衣裙换成一件复古风格的蕾丝长裙，领口和袖口有精致的刺绣细节",
"image": "https://img.alicdn.com/imgextra/i2/O1CN01vHOj4h28jOxUJPwY8_!!6000000007968-49-tps-1344-896.webp",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1280*1280",
"n": 1,
"watermark": false,
"seed": 12345
}
}多参考图生图请求：
json
{
"model": "Wan2.5-I2I-Preview",
"input": {
"prompt": "将图1中的花卉连衣裙换成图2中的复古风格蕾丝长裙，领口和袖口有精致的刺绣细节",
"image": "https://img.alicdn.com/imgextra/i2/O1CN01vHOj4h28jOxUJPwY8_!!6000000007968-49-tps-1344-896.webp",
"image2": "data:image/jpeg;base64,GDU7MtCZz...",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等"
},
"extra_body": {
"provider": {
"enable_image_base64": false,
"enable_image_origin_data": true
},
"size": "1280*1280",
"n": 4,
"watermark": false,
"seed": 12345
}
}响应示例
所有模型都返回标准化的响应格式，示例如下：
json
{
"created": 1736123456,
"data": [
{
"url": "https://dashscope-result-wlcb-acdr-1.oss-cn-wulanchabu-acdr-1.aliyuncs.com/...",
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
],
"usage": {
"total_tokens": 0,
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": {
"text_tokens": 0,
"image_tokens": 0
},
"image_count": 1
},
"provider": "阿里云百炼",
"model": "Qwen-Image-Plus",
"origin_data": { ... } // 可选字段
}说明：
data[].b64_json字段：仅在extra_body.provider.enable_image_base64设置为true时返回。默认值为false，此时响应中不包含b64_json字段origin_data字段：包含供应商 API 的完整原始响应数据。可通过设置extra_body.provider.enable_image_origin_data参数控制是否返回此字段（默认值为false，不会返回）。如需查看不同模型的原始响应格式，请在请求中设置extra_body.provider.enable_image_origin_data: true，然后在响应的origin_data字段中查看供应商返回的原始数据
响应参数说明
成功响应
所有模型都返回标准化的响应格式，包含以下字段：
| 参数名 | 类型 | 必填 | 说明 | 取值范围/格式 |
|---|---|---|---|---|
created | integer | 是 | 响应生成的时间戳（Unix 时间戳） | Unix 时间戳（秒） |
data | array | 是 | 生成的图片数组 | 数组对象，每个元素包含： |
data[].url | string | 是 | 生成的图片 URL，图像格式为 PNG。链接有效期为 24 小时，请及时下载并保存图像 | URL 字符串 |
data[].b64_json | string | 否 | 图像的 Base64 编码数据。控制参数：仅在请求参数 extra_body.provider.enable_image_base64 设置为 true 时返回此字段。默认值为 false，此时不返回此字段 | Base64 编码的字符串 |
usage | object | 是 | 使用情况统计 | 对象类型，包含以下字段： |
usage.total_tokens | integer | 是 | 总 token 数（图像生成场景通常为 0） | 整数 |
usage.input_tokens | integer | 是 | 输入 token 数 | 整数 |
usage.output_tokens | integer | 是 | 输出 token 数 | 整数 |
usage.input_tokens_details | object | 是 | 输入 token 详情 | 对象类型，包含： |
usage.input_tokens_details.text_tokens | integer | 是 | 文本 token 数 | 整数 |
usage.input_tokens_details.image_tokens | integer | 是 | 图像 token 数 | 整数 |
usage.image_count | integer | 是 | 生成的图像数量 | 整数 |
provider | string | 是 | 实际使用的供应商名称 | 字符串，例如 "阿里云百炼" |
model | string | 是 | 实际使用的模型名称（标准模型名） | 字符串 |
origin_data | object | 否 | 供应商的原始响应数据。控制参数：仅在请求参数 extra_body.provider.enable_image_origin_data 设置为 true 时返回此字段。默认值为 false，此时不返回此字段 | 对象类型，包含供应商 API 的完整原始响应 |
错误响应
当 API 调用失败时，会返回供应商的原始错误信息。
错误响应格式:
- 如果响应是 JSON 格式，返回完整的错误 JSON 对象
- 如果响应是文本格式，返回错误文本
- 如果无法解析，返回
HTTP {status_code}
错误响应示例:
json
{
"error": {
"message": "Invalid parameter",
"code": "invalid_param"
}
}注意事项
模型参数限制：不同模型支持的参数不同。对于不在白名单中的参数，系统会记录警告日志，但不会过滤，仍会传递给供应商 API 进行最终判断
参数透传：所有参数（包括
size、image_size、n、batch_size、prompt_extend、watermark、seed等）都会透传给供应商 API，由供应商进行校验和判断默认值：如果未提供某些参数，系统会使用模型特定的默认值：
prompt_extend：true（Qwen-Image-Plus、Qwen-Image、Qwen-Image-Edit-Plus默认开启智能改写），false（Wan2.5-T2I-Preview默认不开启智能改写）watermark：false（默认不添加水印）size：1328*1328（Qwen-Image-Plus、Qwen-Image默认分辨率），1280*1280（Wan2.5-T2I-Preview默认分辨率）n：1（所有模型默认值）
未知参数处理：未知参数会被记录警告日志，但仍会传递给供应商 API，由供应商判断是否返回错误
任务数据保留：任务数据（如任务状态、图像 URL 等）仅保留 24 小时，超时后会被自动清除。请您务必及时保存生成的图像
供应商调度参数：关于
extra_body.provider参数的完整说明和使用示例，请参考供应商调度参数说明