我可以在 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 模型

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

取得免費 API Key 在 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 Source Build

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

使用 Go 1.22+ 從 source build。

QUICKSTART

幾分鐘內開始建構

Terminal

# 基於瀏覽器的登入（laptop）
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、餵入腳本，亦可用任何語言解析。

所有模態

影片、圖片、音樂、音訊和 LLM——一個 CLI 處理所有工作。使用 --model flag 切換模型。

非同步 + 輪詢

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

Shell 自動完成

支援指令、模型名稱和 flag 的 Tab 自動完成。支援 bash、zsh 和 fish。

CLI 的優勢場景

CI/CD 流水線

喺建置流程中生成素材。JSON 輸出可以直接接入 scripts 同自動化工具。

批次處理

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

快速實驗

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

為何開發者選擇 RunAPI CLI

一個工具，所有模型

不用再切換不同 provider 的 CLI。一條指令即可處理影片、圖像、音樂、音訊和 LLM。

適合流水線

支援 JSON 輸出、退出碼和 stdin，可直接接入任何 CI/CD 或 shell script。

內置成本追蹤

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

常見問題

有三種方法：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+ 個模型，含定價、參數同代碼示例。

正在與團隊一起建立？

我們可以協助企業設定、整合和技術問題。

聯絡我們