模型 - Runbase Docs

Runbase 透過單一 API 提供來自多個供應商的頂尖圖片與影片生成模型。

瀏覽模型

造訪模型頁面查看所有可用模型、定價、能力與範例輸出。每個模型都有專屬的詳細頁面，包含：

Playground — 在編寫任何程式碼之前，先在瀏覽器中測試模型
定價 — 每次執行或每秒成本
範例 — 附提示詞的範例輸出
API 參考 — 模型專屬的輸入參數與程式碼範例

Playground

每個模型頁面頂部都包含一個可互動的 Playground。登入後，輸入提示詞，並點擊 Run model，即可在幾秒內看到結果。這是將模型整合到應用程式之前，評估其品質與速度的最快方式。

模型 ID 格式

每個模型都有一個格式為 provider/model-name 的 ID，例如：

openai/gpt-image-2 — 圖片生成
bytedance/seedance-2 — 影片生成
google/veo-3 — 影片生成

可用模型及其 ID 的完整清單在模型頁面。模型會定期新增 — 請到那裡查看最新資訊。

輸入參數

每個模型都定義自己的輸入 schema。常見參數包括：

prompt (string) — 要生成內容的文字描述
aspect_ratio (string) — 輸出尺寸，例如 "1:1"、"16:9"
quality (string) — 生成品質等級
image_urls (string[]) — 參考圖片的 URL（在支援時）

請參閱各模型的詳細頁面，以取得完整的輸入 schema 與可用選項。

使用模型

將模型 ID 與 input 物件傳遞給建立 run 端點：

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedream-5-lite",
    "input": {
      "prompt": "A mountain landscape at sunset, oil painting"
    }
  }'

如果傳入無效的 model ID，您會收到 400 model_not_found 錯誤。如果 input 不符合模型的 schema，您會收到 400 invalid_input，並附上錯誤描述。

圖片模型與影片模型

圖片模型 會在 output.urls 中回傳一個或多個圖片 URL。生成時間會因模型、供應商負載與輸入複雜度而異。
影片模型 會在 output.urls 中回傳影片 URL。生成時間會因模型、時長、解析度與供應商負載而異。

API 的結構對兩者完全相同 — 唯一差異在於輸出 URL 指向的內容。