使用 Qwen-Image 生成和编辑图像。
概览
生成图片时提交提示词,编辑图片时同时提交参考图和编辑要求。响应中的用量分别列出输入参考图和输出图片的张数。
- 版本
- qwen-image-3.0-pro
- 输入 / 输出
- 文本, 图像 / 图像
- 接口路径
- /v1/images/generations, /v1/images/edits
接口协议与接入
Authorization: Bearer ITERACOMPUTE_API_KEY
POST /v1/images/generationsPOST /v1/images/edits
生成或编辑 PNG 图片。输入和输出图片按分辨率档位分别计费。
LLMs.txt
LLMs.txt
# qwen/qwen-image-3.0-pro
Revision: c3cb831641e456ed402a686abb11d6818e34dfd2d071bd98e3934e15b55c5cab
Authorization: Bearer ITERACOMPUTE_API_KEY
POST https://api.iteracompute.com/v1/images/generations
POST https://api.iteracompute.com/v1/images/edits
- prompt · string · 描述要生成的图片或编辑内容。
- size · string · 宽x高。像素总数范围为 262144–4194304。
- n · integer · 免费账户每次可生成 1 张,付费账户每次可生成 1 至 6 张。 · [1, 6] · default=1
- image · array · 编辑时传 1–3 张参考图片,按提示词引用顺序排列。
- seed · integer · 随机种子。 · [0, 2147483647]
- watermark · boolean · 添加水印。 · default=false
安装 requests,设置 ITERACOMPUTE_API_KEY。生成使用 /images/generations。编辑使用 /images/edits,并在 JSON 的 image 数组中按顺序传入 1–3 张参考图。
import os
from pathlib import Path
import requests
base = "https://api.iteracompute.com/v1"
headers = {"Authorization": "Bearer " + os.environ["ITERACOMPUTE_API_KEY"]}
payload = {
"model": "qwen/qwen-image-3.0-pro",
"prompt": "A blue paper boat on a calm lake",
"size": "512x512",
"n": 1
}
r = requests.post(base + "/images/generations", headers=headers, json=payload, timeout=600)
r.raise_for_status()
for item in r.json()["data"]:
print(item["url"])
https://www.alibabacloud.com/help/en/model-studio/qwen-image-generation-and-editing-api-reference接口参数
- 生成或编辑 PNG 图片。输入和输出图片按分辨率档位分别计费。
以下为当前线路接受的参数与取值范围,账户额度和上下文限制同时适用。参数可接收不代表相关模型能力已经完成验证。
- 工具调用
- 不支持
- 推理
- 不支持
- 视觉
- 支持
- 流式输出
- 不支持
- JSON 模式
- 不支持
参数与取值
点击参数名即可复制;表格可横向滚动查看全部列。用途栏标明协议差异,不能将同名字段视为跨接口通用。
| 参数 | 类型 | 接收状态 | 取值范围 | 用途 / 协议 |
|---|---|---|---|---|
| 整数 | 可接收 | [1, 6] | 免费账户每次可生成 1 张,付费账户每次可生成 1 至 6 张。 默认值 1. | |
| 整数 | 可接收 | [0, 2147483647] | 随机种子。 | |
| 字符串 | 可接收 | — | 宽x高。像素总数范围为 262144–4194304。 | |
| 数组 | 可接收 | — | 编辑时传 1–3 张参考图片,按提示词引用顺序排列。 | |
| 字符串 | 可接收 | — | 描述要生成的图片或编辑内容。 必填。 | |
| 布尔值 | 可接收 | — | 添加水印。 默认值 false. |
当前配置调用示例
POST /v1/images/generations
请求示例
{
"model": "qwen/qwen-image-3.0-pro",
"prompt": "A blue paper boat on a calm lake",
"size": "512x512",
"n": 1
}参数版本:c3cb831641e4
API
安装 requests,设置 ITERACOMPUTE_API_KEY。生成使用 /images/generations。编辑使用 /images/edits,并在 JSON 的 image 数组中按顺序传入 1–3 张参考图。
Python
import os
from pathlib import Path
import requests
base = "https://api.iteracompute.com/v1"
headers = {"Authorization": "Bearer " + os.environ["ITERACOMPUTE_API_KEY"]}
payload = {
"model": "qwen/qwen-image-3.0-pro",
"prompt": "A blue paper boat on a calm lake",
"size": "512x512",
"n": 1
}
r = requests.post(base + "/images/generations", headers=headers, json=payload, timeout=600)
r.raise_for_status()
for item in r.json()["data"]:
print(item["url"])价格
美元/张
图像输入 · 1K$0.00252
图像输入 · 2K$0.00252
图像输出 · 1K$0.0336
图像输出 · 2K$0.063
- Model ID
qwen/qwen-image-3.0-pro- 验证范围与来源
查看完整验证范围与来源
2026-11-21 · 通过 SG 网关实测图片生成、编辑、1K 与 2K 计量和密钥隔离,分别验证了最大尺寸和参考图数量。一次同时使用 2K 与三张参考图的编辑超时。
使用限制
- 根据实际输出像素面积区分 1K 和 2K 计费档。
- 免费账户每次可生成 1 张,付费账户每次最多可生成 6 张。
适用任务
接入工具与指南
常见问题
如何接入?
如何计费?
最新上架
查看入选 New Arrivals 的模型,了解 API 价格、已支持能力与接入方式。
Qwen新上架
Qwen3.7-Plus
qwen/qwen3.7-plus
Qwen3.7-Plus 接收文字与视觉输入,生成文本。
IteraCompute 上线日期
- 输入
- $0.384
- 输出
- $1.536
美元 / 百万 tokens
Alibaba Cloud新上架
Wan 3.0 Prime
wan/wan3.0-video-prime
万相 3.0 Prime 可根据文本和参考素材生成视频。
IteraCompute 上线日期
Alibaba Cloud新上架
Wan 3.0
wan/wan3.0-video
万相 3.0 标准版 可根据文本和参考素材生成视频。
IteraCompute 上线日期