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": "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。
輸入結構
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
| 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 張圖片 |
輸出結構
| 欄位 | 類型 | 說明 |
|---|---|---|
| urls | string[] | 產生的輸出 URL |
錯誤
API 使用標準 HTTP 狀態碼表示成功或失敗。
| 狀態碼 | 說明 |
|---|---|
| 400 | Invalid request - missing or malformed parameters |
| 401 | Authentication failed - missing or invalid API key |
| 402 | Insufficient credits |
| 403 | Forbidden - IP not allowed, account banned, or API key credit limit exceeded |
| 404 | Run not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |

