RunAPI CLI。
終端機中的 AI 模型。
一個二進位檔即可呼叫 210+ 個 AI 模型——Suno、Veo、Kling、Flux、Claude、GPT 以及其他模型——並以 JSON-first 輸出，完美對應腳本、CI pipeline 與 agent runtime。
# 安裝
curl -fsSL https://runapi.ai/cli/install.sh | sh
# 驗證
runapi login
# 生成圖片
runapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso"}'
# 生成音樂（fire-and-forget，之後輪詢）
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate什麼是 RunAPI CLI？
RunAPI CLI 是一個 Go 單一執行檔，透過統一 API 呼叫 23 個 provider 的 210+ 個 AI 模型。你不需要分別為 Suno、Kling、Flux、Claude、GPT 安裝不同的 SDK，只要一條指令——runapi <service> <action>——就能取得結構化 JSON 輸出。它內建驗證、非同步輪詢與輸出格式化，讓你的 shell script、CI pipeline 與 agent runtime 保持整潔。每次請求按量計費、無每月最低消費，API 金鑰儲存於本機，驗證一次後即可在任意目錄執行指令。
三種安裝方式
curl (Linux / macOS)
自動偵測作業系統與架構，驗證 SHA-256 checksum，並寫入 /usr/local/bin。
curl -fsSL https://runapi.ai/cli/install.sh | shHomebrew
官方 Homebrew tap。可透過 brew upgrade 自動更新。
brew install runapi-ai/tap/runapiGo 原始碼建置
使用 Go 1.22+ 從原始碼建置。
go install github.com/runapi-ai/cli/cmd/runapi@latest幾分鐘內開始建置
先驗證，然後開始生成。
# 以瀏覽器登入（筆電）
runapi login
# 或匯入 token（CI／無頭環境）
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
# 驗證
runapi auth statusrunapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'
# { "id": "task_abc123", "status": "completed", "output": { ... } }# 適合長時間工作的一次送出、無需等待
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"upbeat indie rock about coding"}' | jq -r .id)
# 持續輪詢直到完成
runapi wait "$TASK_ID" --service suno --action generate為開發者打造
以 JSON 為核心輸出
每個指令都會回傳結構化 JSON——可直接接到 jq、餵給 script，或在任何語言中解析。
非同步 + 輪詢
使用 --async 一次送出、無需等待，接著用 runapi wait 輪詢。專為長時間執行的生成任務而設計。
Agent Runtime
只要一個指令，就能把 CLI skills 安裝到 Claude Code、Codex、Gemini CLI 及其他 agent runtime。
可以生成什麼？
常見問題
CLI 本身免費且開源。你只需為 API 呼叫按量付費，無每月最低消費。圖片生成最低每張 $0.02，影片生成最低每段 $0.10，LLM 呼叫按 token 計費，約比各 provider 官方定價低 50%。
可以。RunAPI 為 Claude Code、Codex、Gemini CLI 等相容 MCP 的 agent runtime 發布了可安裝的模型 skill。執行 runapi skill install 即可新增，agent 就能將 RunAPI 模型作為原生工具使用，無需手動設定 API。