RunAPI CLI。
你的終端機內的 AI 模型。
一個 binary 可呼叫 210+ 個 AI 模型——Suno、Veo、Kling、Flux、Claude、GPT 及其他模型——並以 JSON-first 輸出,方便無縫對接 scripts、CI pipelines 及 agent runtimes。
# 安裝
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 單一 binary,透過統一 API 呼叫 23 個 provider 的 210+ 個 AI 模型。你唔需要分別為 Suno、Kling、Flux、Claude、GPT 安裝唔同 SDK,只需一條指令——runapi <service> <action>——就可以取得結構化 JSON 輸出。佢內建驗證、非同步輪詢同輸出格式化,令你的 shell script、CI pipeline 同 agent runtime 保持整潔。每次請求按量計費、無每月最低消費,API key 儲存於本機,驗證一次後即可喺任意目錄執行指令。
三種安裝方式
curl (Linux / macOS)
自動偵測作業系統及架構,驗證 SHA-256 checksum,寫入 /usr/local/bin。
curl -fsSL https://runapi.ai/cli/install.sh | sh
Homebrew
官方 Homebrew tap。可用 brew upgrade 自動更新。
brew install runapi-ai/tap/runapi
Go Source Build
使用 Go 1.22+ 從 source build。
go install github.com/runapi-ai/cli/cmd/runapi@latest
幾分鐘內開始建構
先驗證,再生成。
# 基於瀏覽器的登入(laptop)
runapi login
# 或匯入 token(CI/無頭模式)
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
# 驗證
runapi auth status
runapi 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、餵入腳本,亦可用任何語言解析。
非同步 + 輪詢
使用 --async 直接發送後不等待,再用 runapi wait 輪詢直到完成。專為長時間生成任務而設。
Agent Runtime
只需一個指令,即可將 CLI skills 安裝到 Claude Code、Codex、Gemini CLI 及其他 agent runtimes。
可以生成甚麼?
常見問題
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。