Qwen 图像编辑 API

利用阿里巴巴先进的 Qwen 图像编辑 API 进行编程化图片处理。上传图片、定义蒙版，并大规模执行复杂的指令式编辑——从文字修正到物体移除。

Image Upload Required

Upload 1-3 reference images to start editing. Supported formats: jpg, png, webp, bmp, tiff.

Prompt

A cute fluffy cat captain sitting in a spaceship commander chair, wearing a small headset and a futuristic collar. Pixar animation style, 3D render, vibrant colors, soft volumetric lighting. The cockpit is cozy with round shapes, galaxy background outside the window. Octane render, high fidelity, adorable expression.

Parameters

image_urls

https://pub-ebac96ac8a0c4c789f53c7470fd2339c.r2.dev/BQACAgUAAyEGAASHRsPbAAEDFHJo3RjyLCNIDyRJPhulBDRTS2e1dQACEBsAAs7-6FbennQ2yXsmjzYE (4).jpg

Estimated Cost (per edit)

3 Credits

Sample Result

Prompt

318 (suggested: 2,000)

Input Images *

Upload up to 3 images (max 10MB each)

Click to upload or drag and drop

Supported formats: JPG, JPEG, PNG, BMP, WEBP, TIFF
Maximum file size: 10MB; Maximum files: 3

History

最多保留20条

0 运行中 · 0 已完成

您的生成历史将显示在这里

Pricing

Starting from

$0.050

3 Credits

per edit

Guaranteed

99.9% Uptime

使用 Qwen 图像编辑 API 自动化修图

使用自然语言指令执行精准的区域编辑。Qwen 图像编辑 API 能够处理局部重绘、双语文字修改以及背景替换，适用于大批量工作流。

Qwen 图像编辑 API 的能力

智能物体与文字移除

编程化擦除水印或 Logo 等不需要的元素，同时自动重构背景纹理。

查看文档

精准文字替换

Qwen 图像编辑 API 的独特优势：修改招牌或海报上的文字，同时保留原始字体和风格。

查看文档

批量图像处理

单次 API 请求可发送 3-6 张图片，对系列产品应用一致的风格或修图规则。

查看文档

为什么开发者选择 Qwen 图像编辑 API

以极具竞争力的价格获取业界领先的语义理解能力，实现基于指令的编辑。

基于指令的控制

使用自然语言（例如“把衬衫改成红色”）引导 Qwen 图像编辑 API，无需复杂的参数微调。

高保真局部重绘

模型理解上下文，确保编辑区域与原始光照和透视完美融合。

高性价比扩展

通过平均每次成功编辑 $0.03–$0.05 的 Token 计费模式，降低运营成本。

如何集成 Qwen 图像编辑 API

处理复杂图像修改的简单“请求-响应”流程。

第 1 步 — 构建请求参数

向端点发送包含 Base64 或 URL 格式底图以及可选蒙版图的 POST 请求。

第 2 步 — 定义指令

向 Qwen 图像编辑 API 传递描述所需更改的文本提示词（例如“把猫换成狗”）。

第 3 步 — 获取与部署

在 JSON 响应中接收处理后的图片 URL，即可立即在您的应用程序中展示。

打开 API 调试台

API 核心特性

专为精细控制和自动化设计

精准度

蒙版引导局部重绘

使用二进制蒙版将编辑限制在特定像素范围内。

效率

多图批处理

单次 API 调用处理小批量（最多 3 张）图片。

构图

场景重构

替换背景同时保持主体景深正确。

排版

文字风格保留

修改内嵌文字而不破坏视觉设计。

全球化

双语指令

原生支持复杂的中英文提示词。

经济性

透明定价

Qwen 图像编辑 API 采用按次付费模式（约 $0.04）。

Qwen 图像编辑 API vs. 替代方案

为您的技术栈选择合适的编程化编辑器

模型	类别	核心能力	输出尺寸	计费方式	最适用场景
Qwen 图像编辑 API	图像编辑	蒙版引导局部重绘、文字替换、局部修饰	灵活（取决于输入）	按成功编辑计费（用量计费）	需要精准局部编辑和文字替换的编程化图像编辑工作流
Wan 2.5 图生图	图像变体 / 风格迁移	基于参考图的变体和重度风格迁移	高清输出（取决于配置）	用量计费	从参考图创建变体和风格转换（通常不太适合精准的局部文字编辑）
Nano Banana 2	文生图	通用图像生成	1024px 基础（取决于配置）	用量计费	不需要蒙版引导局部编辑或文字保留修饰时的通用生成

Qwen 图像编辑 API 常见问题解答

Everything you need to know about the product and billing.

API 支持并发请求，但标准层级通常每次批量调用处理最多 3 张图片。速率限制取决于您的 EvoLink 套餐。

可以，与许多扩散模型不同，Qwen 图像编辑专注于渲染和修改图片内的文字，同时保持原始字体风格。

蒙版应为二进制图像（黑/白），其中白色代表要编辑的区域。分辨率必须与输入图片一致。

支持，您可以扩展画布边界。只需提供覆盖空白空间的蒙版，并提示模型填充新区域即可。

API 接受标准的 Web 格式（JPG, PNG），支持 URL 或 Base64 编码，建议文件大小在 10MB 以内以获得最佳延迟。

定价通常基于 Token/用量。通过 EvoLink，平均每张生成图片约为 $0.04–$0.05，随分辨率略有波动。

API Reference

Select endpoint

Authentication

All APIs require Bearer Token authentication.

Header

Authorization: 
Bearer YOUR_API_KEY

Get API Key

POST

/v1/images/generations

Generate Image

Create an image generation task using text prompts or reference images. Supports text-to-image, image-to-image, and image editing modes.

Asynchronous processing mode, use the returned task ID to .

Generated image links are valid for 24 hours, please save them promptly.

Request Parameters

modelstringRequiredDefault: qwen-image-edit

Image generation model name.

Exampleqwen-image-edit

promptstringRequired

Prompt describing the image to be generated or how to edit the input image.

Notes

Limited to 2000 tokens

ExampleA cat playing in the grass

image_urlsarrayRequired

Reference image URL list for image editing.

Notes

Max 3 images per request
Image dimensions must be within 384-3072 pixels
Formats: .jpg, .jpeg, .png, .bmp, .webp, .tiff
URLs must be directly accessible by the server

Examplehttps://example.com/image1.png

callback_urlstringOptional

HTTPS callback address after task completion.

Notes

Triggered on completion, failure, or cancellation
Sent after billing confirmation
HTTPS only, no internal IPs
Max length: 2048 chars
Timeout: 10s, Max 3 retries

Examplehttps://your-domain.com/webhooks/image-task-completed

Request Example

{
  "model": "qwen-image-edit",
  "prompt": "Replace the background of this image",
  "image_urls": ["https://example.com/image1.png"]
}

Response Example

{
  "created": 1757165031,
  "id": "task-unified-1757165031-uyujaw3d",
  "model": "qwen-image-edit",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 45
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}