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

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

可以使用哪些模型？

透過同一個 CLI，RunAPI 提供來自 26 家供應商的 250+ 個模型。

如何驗證 CLI 身分？

執行 runapi login，或為 CI 和其他無介面環境匯入 RUNAPI_API_KEY。

CLI 支援 Windows 嗎？

支援。RunAPI CLI 支援 Windows、macOS 和 Linux，並在可用的平台上提供 amd64 和 arm64 版本。

可以將 CLI 輸出透過管線傳給其他工具嗎？

可以。JSON 輸出可以直接透過管線傳給 jq、檔案、腳本和自動化工具。

Claude 訪客：新帳戶可在 30 天內獲得 $1.00 API 贈送額度。每人限領一次，僅用於 API 用量。

CLI

從終端機呼叫 AI 模型

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

取得免費 API 金鑰在 GitHub 查看

macOS、Linux、Windows — amd64 與 arm64

Terminal

$ curl -fsSL https://runapi.ai/cli/install.sh | sh

  RunAPI CLI v0.16.0

  Usage: runapi <command> [options]

  Commands:
    login      Authenticate in a browser
    auth       Manage authentication
    account    Read account information
    files      Manage file resources
    pricing    Read schedules and quotes

  Run runapi <command> --help for details

250+

模型

Modalities

<2min

Setup

Install

三種安裝方式

curl (Linux / macOS)

curl -fsSL https://runapi.ai/cli/install.sh | sh

自動偵測作業系統與架構，驗證 SHA-256 checksum，並寫入 /usr/local/bin。

Homebrew

brew install runapi-ai/tap/runapi

官方 Homebrew tap。可透過 brew upgrade 自動更新。

Go 原始碼建置

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

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

QUICKSTART

幾分鐘內開始建置

Terminal

# 以瀏覽器登入（筆電）
runapi login

# 或匯入 token（CI／無頭環境）
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -

# 驗證
runapi auth status

runapi nano-banana text-to-image --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# { "id": "task_id", "status": "completed", "output": { ... } }

# 適合長時間工作的一次送出、無需等待
TASK_ID=$(runapi suno text-to-music --async --input '{"model":"suno-v5","vocal_mode":"instrumental","style":"minimal piano","title":"Short Piano Theme"}' | jq -r '.id')

# 持續輪詢直到完成
runapi wait "$TASK_ID" --service suno --action text-to-music

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

FEATURES

為開發者打造

以 JSON 為核心輸出

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

所有模態

影片、圖片、音樂、音訊和 LLM — 一個 CLI 搞定所有需求。使用 --model 旗標切換模型。

非同步 + 輪詢

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

Shell 補全

支援命令、模型名稱和旗標的 Tab 補全。支援 bash、zsh 和 fish。

CLI 的優勢情境

CI/CD 流水線

在建置流程中產生素材。JSON 輸出可直接串接腳本與自動化工具。

批次處理

用 Shell 迴圈處理數百張圖片或影片。非同步任務管理不會阻塞流程。

快速實驗

從終端機幾秒內測試新模型。不需要程式碼或設定，直接執行 runapi generate。

為什麼開發者選擇 RunAPI CLI

一個工具，所有模型

不必再切換不同提供者的 CLI。一個指令即可處理影片、圖片、音樂、音訊和 LLM。

適合流程

支援 JSON 輸出、結束碼和 stdin，可直接接入任何 CI/CD 或 shell 腳本。

內建成本追蹤

即時查看每次請求的成本，並可按專案設定支出上限。

常見問題

三種方式：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 原始碼建置）。

探索更多

MCP Server

將 Claude Code、Cursor 等相容 MCP 的 agent 連接到 RunAPI 模型。

SDKs

Python、Node.js、PHP、Java、Ruby 與 Go SDK，用於程式化整合。

Skills

一鍵將預建模型 skill 安裝到你的 agent runtime。

模型目錄

瀏覽全部 250+ 個模型，含定價、參數與程式碼範例。

正在與團隊一起打造？

我們可以協助企業接入、整合與技術問題。

聯絡我們