qwen-image-3.0 系列模型的异步图像生成接口
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
"model": "qwen-image-3.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A healing-style hand-drawn poster featuring three puppies playing with a ball on lush green grass."
}
]
}
]
},
"parameters": {
"prompt_extend": true
}
}'{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}POST /services/aigc/image-generation/generation 提交任务，请求头中需包含 X-DashScope-Async: enable。GET /tasks/{task_id} 查询任务状态，直到 task_status 变为 SUCCEEDED 或 FAILED。建议每 10 秒轮询一次。千问AI平台 API Key。详见获取 API Key。
异步处理配置参数。必须设置为 enable。缺少此请求头将报错："current user api does not support synchronous calls"。
模型名称。
包含消息数组的输入数据。
显示子属性
请求内容数组。当前仅支持单轮对话，数组内有且只有一个对象。
图像生成参数。
显示子属性
描述不希望在图像中出现的内容。最多 500 个字符，超出部分自动截断。
输出分辨率，格式为 宽*高。
2048*2048。推荐分辨率：2688*1536（16:9）、1536*2688（9:16）、2048*2048（1:1，默认值）、2368*1728（4:3）、1728*2368（3:4）。1664*928。可选分辨率：1664*928（16:9，默认值）、1472*1104（4:3）、1328*1328（1:1）、1104*1472（3:4）、928*1664（9:16）。生成图像数量。默认值：1。
启用提示词改写。true（默认）：模型先优化提示词再生成；qwen-image-3.0 系列按 prompt_extend_mode 指定的方式改写。false：直接使用原始提示词。
提示词改写方式。仅 qwen-image-3.0 系列支持。
direct（默认）：直接提示词增强（DPE），适用于大多数场景。agent：智能体提示词增强（APE），改写更精细，仅文生图支持。在图像右下角添加 "Qwen-Image" 水印。默认值：false。
是否开启思考模式，默认值为 true。开启时，模型将增强推理能力以提升出图质量，但会增加生成耗时。仅在 prompt_extend=true 时生效，适用于 Direct T2I、Direct I2I 和 Agent T2I，I2I Agent 暂不支持。
随机数种子，范围为 [0, 2147483647]，未传入时服务会随机选择种子。相同种子可产生更一致（但不完全相同）的结果。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--data '{
"model": "qwen-image-3.0-pro",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "A healing-style hand-drawn poster featuring three puppies playing with a ball on lush green grass."
}
]
}
]
},
"parameters": {
"prompt_extend": true
}
}'{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}