生成或编辑图片

POST

/v1/images/generations

使用 qwen-image-3.0-pro 或 qwen-image-3.0 生成图片。

文生图：不传参考图，只提供一条正向提示词。

图生图/图像编辑：传入 1-3 张参考图，并提供一条编辑指令。

prompt_extend_mode=agent 仅支持文生图；图生图请使用 direct。

单次可生成 1-6 张图片。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Header 参数

Body 参数application/json必填

示例

文生图 - 扁平格式（推荐）图生图/图像编辑 - 扁平格式（推荐）文生图 - 阿里云原生格式图生图/图像编辑 - 阿里云原生格式

{
    "model": "qwen-image-3.0-pro",
    "prompt": "生成一张未来城市夜景，霓虹灯倒映在雨后的街道上，电影感构图，细节清晰",
    "prompt_extend": true,
    "prompt_extend_mode": "direct",
    "negative_prompt": "模糊、低清晰度、变形",
    "n": 1,
    "size": "1024x1024",
    "seed": 123456,
    "watermark": false,
    "response_format": "url"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

文生图 - 扁平格式（推荐）图生图/图像编辑 - 扁平格式（推荐）文生图 - 阿里云原生格式图生图/图像编辑 - 阿里云原生格式

curl --location '/v1/images/generations' \
--header 'X-Request-Id: 550e8400-e29b-41d4-a716-446655440000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "qwen-image-3.0-pro",
    "prompt": "生成一张未来城市夜景，霓虹灯倒映在雨后的街道上，电影感构图，细节清晰",
    "prompt_extend": true,
    "prompt_extend_mode": "direct",
    "negative_prompt": "模糊、低清晰度、变形",
    "n": 1,
    "size": "1024x1024",
    "seed": 123456,
    "watermark": false,
    "response_format": "url"
}'

返回响应

🟢200

application/json

图片生成成功

Bodyapplication/json

示例

URL 格式响应Base64 格式响应

{
    "created": 1786032000,
    "data": [
        {
            "url": "https://example.com/generated-image.png",
            "b64_json": "",
            "revised_prompt": ""
        }
    ],
    "metadata": {
        "output": {
            "choices": [
                {
                    "finish_reason": "stop",
                    "message": {
                        "role": "assistant",
                        "content": [
                            {
                                "image": "https://example.com/generated-image.png"
                            }
                        ]
                    }
                }
            ]
        },
        "usage": {
            "output_height": 1024,
            "output_width": 1024,
            "input_image_count": 0,
            "output_image_count": 1
        },
        "request_id": "571ae02f-5c9d-436c-83c2-f221e6df0xxx"
    }
}

🟠400

🟠401

🟠403

🟠413

🟠429

🔴500

🔴502

修改于 2026-08-07 08:45:34

生成

可以@ 的人物说明