1. 概述
使用当前 API Key 已开通的千问图片生成模型生成图片。
baseUrl:https://token.soar.qjclouds.cn/laserEr/00000000/v1completionsPath:/image/generations/{apiType}apiType:TextToImage- 标准地址:
POST {baseUrl}{completionsPath} - 鉴权:
Authorization: Bearer <api_key>
请求地址:https://token.soar.qjclouds.cn/laserEr/00000000/v1/image/generations/TextToImage
2. 鉴权
| Header | 必填 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <api_key> |
Content-Type | 是 | application/json |
3. 请求体
请求体采用阿里云原厂 API JSON 格式。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型编码,以当前 API Key 实际开通的千问图片生成模型为准。 |
input | object | 是 | 模型输入信息。 |
input.messages | array<object> | 是 | 消息列表;仅支持单轮对话,必须且只能包含一个消息对象。 |
input.messages[].role | string | 是 | 消息角色,固定为 user。 |
input.messages[].content | array<object> | 是 | 消息内容列表。 |
input.messages[].content[].text | string | 是 | 正向提示词,描述期望的图片主体、场景、风格和构图。 |
parameters | object | 否 | 图片生成参数。 |
parameters.negative_prompt | string | 否 | 反向提示词,描述不希望出现的内容;支持中英文,最长 500 个字符,超出部分自动截断。 |
parameters.prompt_extend | boolean | 否 | 是否启用提示词智能改写;默认 true,仅优化正向提示词。 |
parameters.watermark | boolean | 否 | 是否在图片右下角添加水印;默认 false。 |
parameters.size | string | 否 | 输出分辨率,格式为 宽*高;具体范围由所选模型决定。 |
parameters.n | integer | 否 | 生成图片数量,默认 1;具体上限由所选模型决定。 |
parameters.seed | integer | 否 | 随机数种子,范围 0–2147483647;相同种子可提高结果稳定性,但不保证完全一致。 |
4. 请求示例
JSON
{
"model": "qwen-image-2.0-cn",
"input": {
"messages": [
{
"role": "user",
"content": [
{
"text": "冬日北京的都市街景,青灰瓦顶、朱红色外墙的两间相邻中式商铺比肩而立,檐下悬挂印有剪纸马的暖光灯笼,在阴天漫射光中投下柔和光晕,映照湿润鹅卵石路面泛起细腻反光。左侧为书法店:靛蓝色老旧的牌匾上以遒劲行书刻着“文字渲染”。店门口的玻璃上挂着一幅字,自上而下,用田英章硬笔写着“专业幻灯片 中英文海报 高级信息图”,落款印章为“1k token”朱砂印。店内的墙上,可以模糊的辨认有三幅竖排的书法作品,第一幅写着“阿里巴巴”,第二幅写着“通义千问”,第三幅写着“图像生成”。一位白发苍苍的老人背对着镜头观赏。右侧为花店,牌匾上以鲜花做成文字“真实质感”;店内多层花架陈列红玫瑰、粉洋牡丹和绿植,门上贴了一个圆形花边标识,标识上写着“2k resolution”,门口摆放了一个彩色霓虹灯,上面写着“细腻刻画 人物 自然 建筑”。两家店中间堆放了一个雪人,举了一老式小黑板,上面用粉笔字写着“Qwen-Image-2.0 正式发布”。街道左侧,年轻情侣依偎在一起,女孩是瘦脸,身穿米白色羊绒大衣,肉色光腿神器。女孩举着心形透明气球,气球印有白色的字:“生图编辑二合一”。里面有一个毛茸茸的卡皮巴拉玩偶。男孩身着剪裁合体的深灰色呢子外套,内搭浅色高领毛衣。街道右侧,一个后背上写着“更小模型,更快速度”的骑手疾驰而过。整条街光影交织、动静相宜。"
}
]
}
]
},
"parameters": {
"negative_prompt": "低分辨率,低画质,肢体畸形,手指畸形,画面过饱和,蜡像感,人脸无细节,过度光滑,画面具有AI感。构图混乱。文字模糊,扭曲。",
"prompt_extend": true,
"watermark": false,
"size": "2048*2048"
}
}5. 响应示例
JSON
{
"output": {
"choices": [
{
"message": {
"role": "assistant",
"content": [
{
"image": "https://dashscope-0484.oss-accelerate.aliyuncs.com/7d/44/20260910/71e29776/7fdf6ec8-839a-4175-a53d-7bcdf047a25e.png?Expires=1789637815&OSSAccessKeyId=LTAI5tPxpiCM2hjmWrFXrym1&Signature=hgUyS5VxaqDs3UKrywBoBrhnc7c%3D"
}
]
},
"finish_reason": "stop"
}
]
},
"usage": {
"image_count": 1
},
"request_id": "44102666-ee7b-47ea-abcb-b46bd3e71a91"
}响应图片 URL 通常具有有效期,请及时下载或转存。