Qwen Image 3.0
ID:
qwen/qwen-image-3Qwen Image 3.0(Qwen-Image-3.0-Pro)是阿里巴巴推出的高级图像生成模型,擅长真实视觉、结构化排版、丰富细节与高质量文字。通过一个 Qwen Image 3.0 API 即可生成与编辑图像,支持精准小字、多语言渲染与复杂构图。
Qwen Image 3.0Qwen-Image-3.0-Pro文生图图像编辑多语言排版
概览
Qwen Image 3.0(Qwen-Image-3.0-Pro)是阿里巴巴推出的高级图像生成模型,擅长真实视觉、结构化排版、丰富细节与高质量文字。通过一个 Qwen Image 3.0 API 即可生成与编辑图像,支持精准小字、多语言渲染与复杂构图。
认证
所有 API 请求需要通过 Authorization 请求头以 Bearer 方式传递有效的 API 密钥。
快速开始
凭证
设置 RUNBASE_API_KEY 环境变量。
Shell
export RUNBASE_API_KEY=your-api-key创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": {
"prompt": "一张陶瓷台灯的电影级产品照片"
}
}'运行记录
运行以异步方式处理。提交请求后,轮询获取结果。
创建运行
Shell
curl -s https://runbase.net/api/v1/runs \
-H "Authorization: Bearer $RUNBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen/qwen-image-3",
"input": { "prompt": "一张陶瓷台灯的电影级产品照片" }
}'获取运行状态
Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
-H "Authorization: Bearer $RUNBASE_API_KEY"获取结果
轮询状态接口,直到 status 为 "succeeded",然后从响应中读取 output.urls。
输入 Schema
| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 必填 | Prompt最多 3000 个字符 |
| aspect_ratio | string | 可选 | Aspect ratio选项: 1:12:33:23:44:39:1616:921:9默认值:1:1 |
| resolution | string | 可选 | Resolution选项: 1k2k默认值:1k |
| image_urls | string[] | 可选 | Reference images最多 14 张图片 |
输出 Schema
| 字段 | 类型 | 描述 |
|---|---|---|
| urls | string[] | 生成的输出 URL |
错误
API 使用标准 HTTP 状态码表示成功或失败。
| 状态码 | 描述 |
|---|---|
| 400 | Ungültige Anfrage – fehlende oder fehlerhafte Parameter |
| 401 | Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel |
| 402 | Unzureichendes Guthaben |
| 403 | Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten |
| 404 | Ausführung nicht gefunden |
| 429 | Rate-Limit überschritten |
| 500 | Interner Serverfehler |

