图像3.0系列（异步）
/api/v1/image/generationHeader Parameters
使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx
异步处理配置参数。HTTP请求只支持异步，必须设置为enable。
Request Body
application/json
模型名称
"qwen-image-3.0" | "qwen-image-3.0-pro"输入参数对象。
请求内容数组。当前仅支持单轮对话，数组内有且只有一个元素。
消息发送者角色，必须设置为user。
消息内容数组，根据使用场景有不同组合：
- 文生图（T2I）：仅包含一个 {"text": "..."} 对象。
- 图生图（I2I）：包含1-3个 {"image": "..."} 对象和1个 {"text": "..."} 对象。
输入图像的 URL 或 Base64 编码数据。图生图（I2I）场景下支持传入1-3张图像。
多图输入时，按照数组顺序定义图像顺序。
图像要求： 图像格式：JPG、JPEG、PNG、BMP、TIFF、WEBP和GIF。 图像分辨率：建议图像的宽和高均在384像素至2048像素之间。 图像大小：不超过10MB。
支持的输入格式：
- 公网URL：支持 HTTP 和 HTTPS 协议。
- Base64 编码：格式为 data:{MIME_type};base64,{base64_data}。
正向提示词，用于描述您期望生成或编辑的图像内容、风格和构图。
支持中英文，推荐不超过4500Token。
注意：仅支持传入一个text，不传或传入多个将报错。
控制图像生成的附加参数。
是否开启提示词智能改写，默认值为 true（建议开启）。开启后，模型会按照 prompt_extend_mode 指定的方式优化正向提示词，对描述较简单的提示词效果提升明显。
提示词改写方式，默认值为 direct。可选值：
- direct：直接提示词增强（DPE），适用于大多数场景。T2I和I2I均支持。
- agent：智能体提示词增强（APE），提供更精细的改写效果。仅支持文生图（T2I），图生图（I2I）场景传入 agent 将返回400错误。
是否开启思考模式，默认值为 true。开启时，模型将增强推理能力以提升出图质量，但会增加生成耗时。仅在 prompt_extend=true 时生效，适用于 Direct T2I、Direct I2I 和 Agent T2I，I2I Agent 暂不支持。
输出图像的数量，支持输出1-6张图片，默认值为1。
设置输出图像的分辨率，格式为宽高，例如"10241024"。未指定时由模型根据提示词自动推荐分辨率。
文生图（T2I）和图生图（I2I）：像素面积范围512512至20482048，宽高比限制1:8至8:1。
反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制。
随机数种子，取值范围[0,2147483647]。
使用相同的seed参数值可使生成内容保持相对稳定。若不提供，算法将自动使用随机数种子。
是否在图像右下角添加 "Qwen-Image" 水印。默认值为 false。
Response Body
application/json
成功
TypeScript Definitions
Use the response body type in TypeScript.
状态码
数据对象
结果集
消耗信息
图片张数
视频秒数
输入token数
总token数
输出token数
有效期
任务ID
任务状态
状态信息
请求ID
application/json
curl -X POST "https://api.aa.com.cn/api/v1/image/generation" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen-image-3.0", "input": { "messages": [ { "role": "string", "content": [ {} ] } ] } }'{
"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"
}{
"output": {
"task_status": "string",
"task_id": "string"
},
"request_id": "string"
}