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

图像编辑同步调用

POST/api/v1/image/generation

Header Parameters

Authorization?string

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

Request Body

application/json

model*string

模型名称

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

输入参数对象

messages *array<object>

请求内容数组。当前仅支持单轮对话,因此数组内有且只有一个对象,该对象包含role和content两个属性。

[]?object
role*string

消息发送者角色,必须设置为user。

content*array<object>

消息内容,包含1-3张图像,格式为 {"image": "..."};以及单个编辑指令,格式为 {"text": "..."}。

[]?object
image*string

输入图像的 URL 或 Base64 编码数据。支持传入1-3张图像。

多图输入时,按照数组顺序定义图像顺序,输出图像的比例以最后一张为准。

图像要求: 图像格式:JPG、JPEG、PNG、BMP、TIFF、WEBP和GIF。 输出图像为PNG格式,对于GIF动图,仅处理其第一帧。 图像分辨率:为获得最佳效果,建议图像的宽和高均在384像素至3072像素之间。分辨率过低可能导致生成效果模糊,过高则会增加处理时长。 图像大小:不超过10MB。

text*string

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

支持中英文,长度上限为 800 Token,超出部分将自动截断。

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

parameters?object

控制图像生成的附加参数。

n?integer

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

对于qwen0image-2.0系列、qwen-image-edit-max、qwen-image-edit-plus系列模型,可选择输出1-6张图片。

对于qwen-image-edit,仅支持输出1张图片。

negative_prompt?string

反向提示词,用来描述不希望在画面中看到的内容,可以对画面进行限制。

支持中英文,长度上限500个字符,每个汉字、字母、数字或符号计为一个字符,超过部分会自动截断。

示例值:低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。

size?string

设置输出图像的分辨率,格式为宽高,例如"10241536"。

支持模型:除qwen-image-edit以外的模型。qwen-image-edit的分辨率尺寸由模型自动决定。

qwen-image-2.0系列模型:

图像总像素需在512512至20482048之间。

默认总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。

qwen-image-edit-max、qwen-image-edit-plus系列模型:

宽和高的取值范围均为[512, 2048]像素。

默认总像素数接近 1024*1024,宽高比与输入图(多图输入时为最后一张)相近。

指定 size 参数,系统会以 size指定的宽高为目标,将实际输出图像的宽高调整为最接近的16的倍数。例如,设置10331032,输出图像尺寸为10401024。

prompt_extend?boolean

是否开启提示词智能改写,默认值为 true。开启后,模型会优化正向提示词(text),对描述较简单的提示词效果提升明显。

支持模型:除qwen-image-edit以外的模型。

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-edit",    "input": {      "messages ": [        {          "role": "string",          "content": [            {              "image": "string",              "text": "string"            }          ]        }      ]    },    "parameters": {      "n": 0,      "negative_prompt": "string",      "size": "string",      "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"
}