我要如何安裝 RunAPI CLI？

三種方式：curl -fsSL https://runapi.ai/cli/install.sh | sh（自動偵測作業系統與架構）、brew install runapi-ai/tap/runapi（Homebrew），或 go install github.com/runapi-ai/cli/cmd/runapi@latest（以 Go 原始碼建置）。

CLI 支援哪些平台？

支援 macOS 與 Linux，架構為 amd64 和 arm64。curl 安裝腳本會自動偵測你的作業系統與 CPU、驗證 SHA-256 checksum，並將 binary 寫入 /usr/local/bin。

我可以在 CI pipeline 中使用 CLI 嗎？

可以。請在 CI/CD pipeline 中使用 curl 安裝程式，並將 RUNAPI_API_KEY 設為環境變數。CLI 也支援透過 runapi auth import-token 進行無頭驗證，適用於非互動式環境。

我可以透過 CLI 執行哪些 AI 模型？

超過 130 個模型，涵蓋 18 家 provider：Suno 用於音樂、Kling 和 Veo 用於影片、Flux 和 Nano Banana 用於圖片、ElevenLabs 用於音訊，以及 Claude、GPT、Gemini、DeepSeek 等 LLM。

非同步任務是怎麼運作的？

使用 --async 參數一次送出、無需等待。CLI 會立即回傳 task ID。接著使用 runapi wait TASK_ID 持續輪詢直到完成。JSON 輸出也讓你能用 jq 輕鬆擷取 task ID。

CLI

RunAPI CLI。
終端機中的 AI 模型。

一個二進位檔即可呼叫 130+ 個 AI 模型——Suno、Veo、Kling、Flux、Claude、GPT 以及其他模型——並以 JSON-first 輸出，完美對應腳本、CI pipeline 與 agent runtime。

取得免費 API 金鑰在 GitHub 查看

macOS、Linux — amd64 與 arm64

快速開始

runapi

# 安裝
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 <service> <action> --input '{...}' JSON

一個二進位檔，130+ 個模型。為腳本與 pipeline 提供 JSON-first 輸出。

INSTALL

三種安裝方式

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 原始碼建置

使用 Go 1.22+ 從原始碼建置。

go install github.com/runapi-ai/cli/cmd/runapi@latest

QUICKSTART

幾分鐘內開始建置

先驗證，然後開始生成。

# 以瀏覽器登入（筆電）
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

runapi <service> <action> --input '{...}' JSON

FEATURES

為開發者打造

以 JSON 為核心輸出

每個指令都會回傳結構化 JSON——可直接接到 jq、餵給 script，或在任何語言中解析。

非同步 + 輪詢

使用 --async 一次送出、無需等待，接著用 runapi wait 輪詢。專為長時間執行的生成任務而設計。

Agent Runtime

只要一個指令，就能把 CLI skills 安裝到 Claude Code、Codex、Gemini CLI 及其他 agent runtime。

FAQ

常見問題

準備好從終端機執行 AI 模型了嗎？

安裝 CLI，幾分鐘內就能開始生成。

取得免費 API 金鑰

RunAPI CLI。終端機中的 AI 模型。