執行
run 是單次生成請求。當你呼叫 API 時，Runbase 會建立一個 run，將其送到底層 AI 模型，並在結果準備好後返回。
每個 run 都會經歷一個生命週期：
POST /api/v1/runs → pending → processing → succeeded (or failed)
Run 狀態
| 狀態 | 含義 |
|---|---|
pending | 已排隊，等待 worker 取用 |
processing | 正在 AI 提供方上積極生成 |
succeeded | 生成完成 — output.urls 包含結果 |
failed | 生成失敗 — error 說明出錯原因 |
以非同步為設計核心
所有生成都是非同步的。當你建立一個 run 時，API 會立即返回 status: "pending" 和一個 run ID。接著你輪詢 GET /api/v1/runs/:id，直到狀態變為 succeeded 或 failed。
完成時間會因模型、提供方負載以及輸入複雜度而異：
- 圖片模型 通常比影片模型完成得更快
- 影片模型 很大程度上取決於時長、解析度和提供方佇列時間
費用與退款
費用會在 run 建立時 從你的餘額中扣除，而不是在完成時才扣除。這會預先保留資金。
如果 run 失敗，完整費用會自動退回到你的餘額。你不會為失敗的生成付費。
模型
Runbase 是連接多個提供方模型的統一入口。每個模型都有一個唯一 ID，格式為 provider/model-name（例如，openai/gpt-image-2、bytedance/seedance-2）。
所有模型都共用相同的雙端點 API：
POST /api/v1/runs— 使用模型 ID 和輸入建立一個 runGET /api/v1/runs/:id— 檢查狀態並取得結果
輸入 schema 會因模型而異（prompt、size、quality、image_urls 等參數不同），但請求/回應包裝格式始終相同。
身分驗證
每個 API 請求都需要在 Authorization 標頭中使用 Bearer token 提供 API key。Key 以 sk- 開頭，並可在 dashboard 中建立。詳情請參閱 Authentication。
餘額
Runbase 使用預付餘額。你先為餘額充值，每個 run 會依據該模型的定價從中扣除。詳情請參閱 Billing。