典名词元典名词元首页
API 文档三方工具教程
AI 模型接口图像千问

图像生成同步调用

POST/api/v1/image/generation

Header Parameters

Authorization?string

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

model*string

模型名称,固定值:

qwen-image-plus

qwen-image-max

qwen-image-2.0

qwen-image-2.0-pro

Value in"qwen-image-plus" | "qwen-image-max" | "qwen-image-2.0" | "qwen-image-2.0-pro"
input*object

输入的基本信息,如提示词等。

messages*array<object>

请求内容数组。当前仅支持单轮对话,数组内有且只有一个元素。

[]?object
role*string

消息的角色。此参数必须设置为user。

content*array<object>

消息内容数组。

[]?object
text*string

正向提示词用于描述您期望生成的图像内容、风格和构图。

支持中英文,qwen-image-2.0系列模型长度上限为 1300 Token,其他模型为 800 Token,超出部分将自动截断。

注意:仅支持传入一个text,不传或传入多个将报错。

parameters?object

图像处理参数。

negative_prompt?string

反向提示词,用于描述不希望在图像中出现的内容,对画面进行限制。

支持中英文,长度不超过500个字符,超出部分将自动截断。

示例值:低分辨率,低画质,肢体畸形,手指畸形,画面过饱和,蜡像感,人脸无细节,过度光滑,画面具有AI感。构图混乱。文字模糊,扭曲。

size?string

qwen-image-2.0系列模型:输出图像总像素需在512512至20482048之间,默认分辨率为2048*2048。

推荐分辨率:

2688*1536 :16:9

1536*2688 :9:16

2048*2048(默认值):1:1

2368*1728 :4:3

1728*2368 :3:4

qwen-image-max、qwen-image-plus系列模型:默认分辨率为1664*928。可选的分辨率及其对应的图像宽高比例为:

1664*928(默认值):16:9

1472*1104:4:3

1328*1328:1:1

1104*1472:3:4

928*1664:9:16

n?integer

输出图像的数量,默认值为1。

对于qwen-image-max、qwen-image-plus系列模型,此参数固定为1,设置其他值将导致报错。

prompt_extend?boolean

是否开启 Prompt(提示词)智能改写功能。开启后模型将对正向提示词进行优化与润色。此功能不会修改反向提示词。

true:默认值,开启智能改写。如果希望图像内容更多样化,由模型补充细节,建议开启此选项。

false:关闭智能改写。如果图像细节更可控,建议关闭此选项。

watermark?boolean

是否在图像右下角添加 "Qwen-Image" 水印。默认值为 false。

seed?integer

随机数种子,取值范围[0,2147483647]。

使用相同的seed参数值可使生成内容保持相对稳定。若不提供,算法将自动使用随机数种子。

注意:模型生成过程具有概率性,即使使用相同的seed,也不能保证每次生成结果完全一致。

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "model": "qwen-image-plus",    "input": {      "messages": [        {          "role": "user",          "content": [            {              "text": "string"            }          ]        }      ]    },    "parameters": {      "negative_prompt": "string",      "size": "string",      "n": 0,      "prompt_extend": true,      "watermark": true,      "seed": 0    }  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}