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": "A cinematic product photo of a ceramic lamp"
    }
  }'

執行紀錄

執行為非同步處理。提交請求後,輪詢取得結果。

建立執行

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": "A cinematic product photo of a ceramic lamp" }
  }'

取得執行狀態

Shell
curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

取得結果

輪詢狀態端點,直到 status 為 "succeeded",然後從回應中讀取 output.urls。

輸入結構

參數類型必填說明
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 張圖片

輸出結構

欄位類型說明
urlsstring[]產生的輸出 URL

錯誤

API 使用標準 HTTP 狀態碼表示成功或失敗。

狀態碼說明
400Invalid request - missing or malformed parameters
401Authentication failed - missing or invalid API key
402Insufficient credits
403Forbidden - IP not allowed, account banned, or API key credit limit exceeded
404Run not found
429Rate limit exceeded
500Internal server error