BEST API FOR OPENCLAW

OpenClaw 最佳 API：一個 Key 涵蓋大型語言模型、圖片、影片和音樂

OpenClaw 支援 chat、image_generate、video_generate 和 music_generate — 但大多數 API 供應商只涵蓋其中一兩種。RunAPI 以一個 key、來自 18 家供應商的 113+ 款模型和按量計費（最低每次 2 美分）涵蓋全部四種。

免費取得 API Key 查看 API 文件

June 11, 2026 更新 RunAPI Editorial Team

Prompt

Configure RunAPI as an API provider in this OpenClaw workspace.

- Add a provider named "runapi" with baseUrl "https://runapi.ai/v1".
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use api "openai-completions".
- Register model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.

Sign up at https://runapi.ai to get your API key.

Copy prompt → paste in OpenClaw runapi/gpt-5.5

QUICK ANSWER

什麼樣的 API 供應商最適合 OpenClaw？

OpenClaw agent 使用四種工具類型：用於大型語言模型的 chat、image_generate、video_generate 和 music_generate。只涵蓋大型語言模型的供應商會讓三種工具無法設定。只涵蓋圖片的供應商仍有兩個空缺。RunAPI 是唯一一個用 113+ 款模型填滿所有四個插槽的單 key 供應商，讓你只需設定一個 baseUrl 和一個 API key，而不是管理四個獨立服務的憑證。

大型語言模型：20+ 款對話模型

透過 OpenAI 相容的 /v1/chat/completions 端點使用 Claude、GPT、Gemini、DeepSeek 等模型。支援串流回應或同步輸出。

圖片：30+ 款生成模型

Flux Kontext、Nano Banana、GPT Image、Imagen 4、Seedream、Ideogram 等。支援文生圖、圖生圖、編輯、混合、超解析度、背景移除。

影片：25+ 款生成模型

Kling、Veo、Seedance、Hailuo、Wan、Runway 和 Luma。支援文生影片、圖生影片和影片編輯，配合非同步任務輪詢。

音樂：Suno API 直連

透過直接 API 存取 Suno v4、v4.5、v4.5-plus、v5 和 v5.5。支援自訂模式、延伸、混音和歌詞生成，無需第三方橋接。

WHAT SETS RUNAPI APART

OpenClaw 開發者選擇 RunAPI 而非單模態 API 的原因

OpenClaw 教學展示了開發者同時使用 Replicate 處理圖片（每 28 張 1 美元）、獨立大型語言模型供應商，以及音樂橋接服務的情況。每個供應商意味著單獨的 API key、單獨的計費控制台和單獨的故障點。RunAPI 將這些整合為一個串接點。

一個 key 替代四個

在 OpenClaw 中設定一次 RunAPI，全部四種工具類型即可使用：chat、image_generate、video_generate 和 music_generate。無需安裝額外技能，無需 ComfyUI 外掛，無需 Suno 的第三方橋接。

模型切換降低成本

運行 OpenClaw agent 的開發者透過將日常任務路由到更低成本的模型，將月度 API 費用從 1000 美元降至 1 美元。RunAPI 的 113+ 款模型目錄讓同樣的策略在所有四種模態中都可行。

OpenAI 相容端點

OpenClaw 已經支援自訂 OpenAI 相容供應商。將 baseUrl 指向 https://runapi.ai/v1，設定 API key，RunAPI 目錄中的每款模型都可立即使用，無需撰寫自訂技能程式碼。

按量計費，無訂閱

無月度最低消費，無到期積分包，無分級套餐。你只為 OpenClaw agent 實際生成的內容付費。需要時儲值，不需要時停止消費。

DECISION TABLE

哪款 API 供應商適合各種 OpenClaw 使用場景？

需求	最佳選擇	原因
僅 LLM 對話，無媒體生成	OpenAI 或 RunAPI	兩者均可作為 OpenAI 相容供應商。RunAPI 提供更多模型選擇和更低成本選項。
OpenClaw agent 中的圖片生成	RunAPI	透過一個端點存取 30+ 款圖片模型。無需安裝額外技能或設定 ComfyUI。
OpenClaw agent 中的影片生成	RunAPI	25+ 款影片模型，包含 Kling、Veo 和 Seedance。沒有其他單 key 供應商能涵蓋如此深度的影片模型。
OpenClaw agent 中的音樂生成	RunAPI	無需第三方橋接直接存取 Suno API。其他供應商不提供音樂生成。
一個 key 涵蓋全部四種模態	RunAPI	唯一透過一個 API key 和一個計費帳戶涵蓋大型語言模型、圖片、影片和音樂的供應商。
最低成本的圖片生成	Runware 或 RunAPI	Runware 每美元可生成 1670 張圖片。RunAPI 在廣度上有競爭力：一個 key 涵蓋圖片、影片、音樂和大型語言模型。

PROVIDER COMPARISON

RunAPI vs OpenAI vs fal.ai vs Replicate vs OpenRouter

比較維度	RunAPI	OpenAI	fal.ai	Replicate	OpenRouter
大型語言模型	20+ 款：Claude、GPT、Gemini、DeepSeek。OpenAI 相容端點。	僅 GPT 系列。原生 API。	無大型語言模型。僅圖片和影片。	部分大型語言模型。非 OpenAI 相容。	100+ 款大型語言模型。OpenAI 相容。無媒體生成。
圖片模型	30+ 款：Flux、Nano Banana、GPT Image、Imagen 4、Seedream、Ideogram、Recraft。	僅 GPT Image。	20+ 款：Flux、Stable Diffusion 及社群模型。	大型模型庫。部分模型每 28 張 1 美元。	無圖片生成。
影片模型	25+ 款：Kling、Veo、Seedance、Hailuo、Wan、Runway、Luma。	無影片生成。	影片模型有限。	部分影片模型。單次生成成本較高。	無影片生成。
音樂模型	Suno v4 至 v5.5。自訂模式、延伸、混音、歌詞生成。	無音樂生成。	無音樂生成。	無音樂生成。	無音樂生成。
定價模式	按量計費。無訂閱。積分不過期。	按量計費。大多數模型單次呼叫成本較高。	按量計費。圖片定價有競爭力，約每張 4 美分。	按運算秒數收費。各模型成本差異較大。	按量計費。僅大型語言模型。
OpenAI 相容性	是。/v1/chat/completions 與 OpenClaw 開箱即用。	是。原生 OpenAI API。	否。自訂 REST API。	否。自訂 REST API。	是。/v1/chat/completions。僅大型語言模型。
免費額度	免費註冊。首次呼叫即按量計費。	新帳戶有限額免費額度。	有限月度免費額度。	有限免費運算秒數。	特定模型有限免費額度。

PRODUCTION CHECKLIST

在生產環境運行 OpenClaw agent 前需要核查的內容

能運行的 demo 不等於生產就緒的部署。這四項檢查能防止 OpenClaw 開發者在第一週之後常見的問題：意外帳單、工具呼叫失敗、缺少錯誤處理和憑證洩露。

憑證

將 API key 儲存在環境變數中

在 shell profile 或 CI secrets 中設定 RUNAPI_API_KEY。永遠不要將 API key 貼到 OpenClaw 上下文視窗或提交到版本控制。OpenClaw 設定在執行時讀取 ${RUNAPI_API_KEY}。

成本控制

按模型成本路由任務

日常程式碼審查使用 gpt-5.4-mini 等低成本模型，複雜推理任務保留高級模型。同樣的策略適用於圖片：草稿使用快速模型，最終輸出使用專業模型。

錯誤處理

處理 402 和 429 回應

402 表示積分不足，429 表示超出速率限制。兩者都可恢復。設定 OpenClaw 在 429 時帶退避重試，在 402 時告警，以便在 agent 卡住之前儲值。

監控

按模態追蹤消費

使用 RunAPI 控制台按模型和端點監控每日消費。在長時間運行的 agent 會話前設定預算告警。每週審查用量明細，發現成本最佳化機會。

USE CASE GUIDE

帶圖片生成能力的程式設計 agent

需要在程式碼旁邊生成 UI 原型圖、產品照片或示意圖的 OpenClaw agent。透過 RunAPI 將 image_generate 工具呼叫路由到 Flux Kontext、Nano Banana 或 GPT Image。

圖片生成指南

帶影片和音樂的內容 agent

用於製作行銷影片、社群短片或演示背景音樂的 OpenClaw 工作流。將 video_generate 路由到 Kling 或 Veo，將 music_generate 路由到 Suno。

影片 API 比較

多模型成本最佳化

根據任務複雜度在低成本和高級模型之間切換的 agent。簡單任務用 gpt-5.4-mini，複雜推理用 gpt-5.5，圖片生成用 flux-kontext-pro，全部透過一個 API key。

查看價格

API EXAMPLES

四種模態，一個 API key，一份 OpenClaw 設定

這些是你的 OpenClaw agent 透過 RunAPI 發送的實際請求體。每種模態使用不同的端點，但共用同一個 API key 和認證方式。修改 model 欄位即可切換模型。

RunAPI 請求

{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "Summarize this pull request"
    }
  ],
  "stream": true
}

POST /v1/chat/completions 非同步任務

{
  "model": "flux-kontext-pro",
  "prompt": "Product photo of wireless headphones on marble surface"
}

POST /api/v1/task/text_to_image 非同步任務

{
  "model": "kling-3.0",
  "prompt": "Drone flyover of a coastal city at golden hour",
  "duration": "5"
}

POST /api/v1/task/text_to_video 非同步任務

{
  "model": "suno-v4.5",
  "prompt": "Upbeat jazz piano loop, 120 BPM, no vocals",
  "duration": 30
}

POST /api/v1/task/text_to_music 非同步任務

SETUP GUIDE

如何在 OpenClaw 中設定 RunAPI

設定 API key

建立免費 RunAPI 帳戶，從控制台產生 API key，並在你的 shell profile 中將其匯出為 RUNAPI_API_KEY。OpenClaw 在啟動時從環境變數讀取該 key。

將 RunAPI 添加為供應商

開啟 OpenClaw 設定，添加自訂供應商，設定 baseUrl 為 https://runapi.ai/v1，api 設為 openai-completions，並填入你想使用的模型 ID，例如 gpt-5.5。將 models.mode 設為 merge 以保留現有供應商。

驗證並啟動

執行 openclaw models status 確認 RunAPI 模型出現。用 openclaw models set runapi/gpt-5.5 切換到該模型，然後啟動 OpenClaw 會話。圖片、影片和音樂工具透過同一個 API key 運作。

DEVELOPER DIFFERENCES

切換到 RunAPI 後 OpenClaw 有什麼變化

查看模型目錄

無需安裝額外技能

設定

其他供應商需要自訂 GitHub 技能、bash 腳本或 ComfyUI 外掛才能在 OpenClaw 中生成媒體內容。RunAPI 透過標準 OpenAI 相容供應商介面運作，無需額外安裝。

閱讀設定指南

Suno 直連

音樂

OpenClaw 音樂生成教學通常展示多跳架構：Telegram 到 OpenClaw，再到橋接服務，最後到 Suno。RunAPI 直接提供 Suno v4 至 v5.5，去掉了橋接層及其故障點。

查看 Suno 模型

模型級成本控制

定價

RunAPI 的目錄讓你為每項任務選擇性價比最優的方案。用 gpt-5.4-nano 處理簡單分類，gpt-5.5 處理複雜推理，flux-kontext-pro 生成生產級圖片，suno-v4 生成草稿音樂。

查看定價

一致的非同步生命週期

工作流程

圖片、影片和音樂任務共享相同的建立-輪詢-Webhook 生命週期。你的 OpenClaw agent 建立任務、輪詢直至完成，並接收輸出 URL。從 Kling 切換到 Veo 只需更改模型欄位，無需修改整合程式碼。

閱讀 API 文件

PRICING COMPARISON

API 費用因供應商和模態而異

圖片生成費用從 Replicate 的每 28 張 1 美元到 Runware 的每美元 1,670 張不等。大型語言模型費用取決於模型和 token 數量。RunAPI 對所有模態採用按量計費，無訂閱費、無到期積分、無最低消費。請查閱即時定價頁面了解當前每次呼叫費率。

查看即時定價閱讀 API 文件

方法論

定價資料來自供應商文件、公開 API 定價頁面及開發者社群報告（截至 2026 年 6 月）。費用頻繁變動，請在正式部署前務必於供應商定價頁面確認當前費率。

FAQ

OpenClaw 最佳 API — 常見問題

OpenClaw 可以使用 RunAPI 進行圖片、影片和音樂生成嗎？

可以。RunAPI 透過一個 API key 提供跨大型語言模型、圖片、影片和音樂模態的 113+ 款模型。在 OpenClaw 中將 RunAPI 設定為自訂 OpenAI 相容供應商後，所有四種工具類型無需額外技能或外掛即可使用。

RunAPI 比直接使用 OpenAI 作為 OpenClaw 的費用更低嗎？

RunAPI 提供相同的 OpenAI 模型加上 90+ 種替代方案，且定價具競爭力。僅靠切換模型就能大幅降低費用。日常任務使用 gpt-5.4-mini，複雜工作再使用進階模型。

在 OpenClaw 中使用圖片生成需要安裝自訂技能嗎？

使用 RunAPI 則不需要。其他供應商需要 GitHub 技能或 ComfyUI 外掛。RunAPI 透過標準 OpenAI 相容端點運作，因此 OpenClaw 內建的 image_generate 工具無需額外設定即可連接。

RunAPI 如何處理 OpenClaw 的 Suno 音樂生成？

RunAPI 直接提供 Suno v4 至 v5.5 的 API 存取。你的 OpenClaw agent 呼叫 music_generate 工具，該工具向 RunAPI 的 Suno 端點發送請求。無需第三方橋接或單獨的 Suno 帳戶。

我可以保留現有的 OpenClaw 供應商並新增 RunAPI 嗎？

可以。在 OpenClaw 設定中將 models.mode 設為 merge。RunAPI 成為現有供應商之外的另一個供應商。你可以將 RunAPI 設為主要模型，或將其作為特定模態的備用選項。

如果在 OpenClaw 工作階段中 RunAPI 積分用盡會怎樣？

RunAPI 會回傳 402 狀態碼。你的 OpenClaw agent 會收到積分不足的錯誤並停止生成。透過 RunAPI 控制台新增積分後，agent 立即恢復運作。無需訂閱。

GET STARTED

一個 API key。四種模態。113+ 款模型。

在 OpenClaw 中設定一次 RunAPI，你的程式設計 agent 就能透過單一 API key 和計費帳戶存取大型語言模型對話、圖片生成、影片生成和音樂創作。

免費取得 API Key 開啟文件