Runbase

Command Palette

Search for a command to run...

Qwen

Qwen Image 3.0

ID:qwen/qwen-image-3

Qwen 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

参数类型必填描述
promptstring必填Prompt最多 3000 个字符
aspect_ratiostring可选Aspect ratio选项: 1:12:33:23:44:39:1616:921:9默认值:1:1
resolutionstring可选Resolution选项: 1k2k默认值:1k
image_urlsstring[]可选Reference images最多 14 张图片

输出 Schema

字段类型描述
urlsstring[]生成的输出 URL

错误

API 使用标准 HTTP 状态码表示成功或失败。

状态码描述
400Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402Unzureichendes Guthaben
403Zugriff verweigert – IP nicht erlaubt, Konto gesperrt oder Ausgabenlimit des API-Schlüssels überschritten
404Ausführung nicht gefunden
429Rate-Limit überschritten
500Interner Serverfehler