图像生成
概览
- 请求方法:
POST - 路径:
/v1/images/generations - 内容类型:
application/json
认证方式
Authorization: Bearer sk-xxx(必选)
请求示例
Header
| Header | 示例 | 必填 |
|---|---|---|
| Content-Type | application/json | 是 |
| Authorization | Bearer sk-xxxx | 是 |
请求体(JSON)
json
{
"model": "qwen-image",
"prompt": "一张 C4D 风格的电商促销海报,画面以蓝色为主色调,整体呈现出清新、活泼的氛围。海报上方有巨大的 “V-API 双十一预售来了”立体文字,视觉冲击力强。中间是一个蓝色的ai角色,旁边有一个更小的ai角色。周围还有一些小型的机器人模型和蓝色的机械设备,营造出一种热闹的促销场景。底部有黄色的“全场满 399 元减 99”字样,突出了促销信息。",
"n": 1,
"size": "1328x1328",
"response_format": "url",
"negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良",
"prompt_upsampling": true,
"seed": "123456"
}参数说明
| 参数 | 类型 | 必填 | 默认 | 描述 |
|---|---|---|---|---|
| prompt | string | 是 | - | 所需图像的文本描述,最大800字符 |
| model | string | 是 | - | 模型名称:qwen-image/wan2.2-t2i-flash/wan2.2-t2i-plus |
| n | number | 否 | 1 | 生成数量,qwen-image仅支持1 |
| size | string | 否 | 1328x1328 | 图片尺寸,支持文档头部所列尺寸 |
| response_format | string | 否 | url | 返回格式,url 或 b64_json |
| negative_prompt | string | 否 | - | 反向提示词,排除不希望的内容 |
| prompt_upsampling | boolean | 否 | true | 是否启动提示词智能改写 |
| seed | string | 否 | - | 随机种子 [0,2147483647] |
返回示例(200)
json
{
"created": 1757255628,
"data": [
{
"url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/7d/ef/20250907/0eea5e95/36e551bc-216a-4e88-bfa6-72dc738722a6-1.png?Expires=1757861427&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=mCw%2FUlMTfV1xXrloIg63uXO4Q70%3D"
}
],
"usage": {
"total_tokens": 0,
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": {
"text_tokens": 0,
"image_tokens": 0
}
}
}