如何安裝 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 模型？

涵蓋 18 個 provider、超過 130 個模型：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 模型。

一個 binary 可呼叫 130+ 個 AI 模型——Suno、Veo、Kling、Flux、Claude、GPT 及其他模型——並以 JSON-first 輸出，方便無縫對接 scripts、CI pipelines 及 agent runtimes。

取得免費 API Key 在 GitHub 查看

macOS, Linux — amd64 and arm64

Quickstart

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

一個 binary，130+ 個模型。為 scripts 和 pipelines 提供 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 Source Build

使用 Go 1.22+ 從 source build。

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

QUICKSTART

幾分鐘內開始建構

先驗證，再生成。

# 基於瀏覽器的登入（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

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

FEATURES

為開發者而設

以 JSON 為先的輸出

每個指令都會回傳結構化 JSON —— 可接到 jq、餵入腳本，亦可用任何語言解析。

非同步 + 輪詢

使用 --async 直接發送後不等待，再用 runapi wait 輪詢直到完成。專為長時間生成任務而設。

Agent Runtime

只需一個指令，即可將 CLI skills 安裝到 Claude Code、Codex、Gemini CLI 及其他 agent runtimes。

FAQ

常見問題

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

安裝 CLI，幾分鐘內即可開始生成。

取得免費 API Key

RunAPI CLI。你的終端機內的 AI 模型。