CLI

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

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

macOS, Linux, Windows — 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,210+ 個模型。為 scripts 和 pipelines 提供 JSON-first 輸出。
概述

甚麼是 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 儲存於本機,驗證一次後即可喺任意目錄執行指令。

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。

支援的服務

可以生成甚麼?

圖像生成

Flux、Nano Banana、Recraft、Ideogram、Seedream、GPT Image、Imagen 4——根據文字描述生成同編輯圖像。

瀏覽模型 →

影片生成

Kling、Veo、Runway、Luma、Hailuo、Wan、Seedance——內建非同步輪詢的文字轉影片生成。

瀏覽模型 →

音樂 & 音訊

Suno 生成音樂,ElevenLabs 提供文字轉語音同聲音複製,InfiniteTalk 用於會說話的虛擬形象。

瀏覽模型 →

LLM 對話 & 補全

Claude、GPT、Gemini、DeepSeek、Grok、Qwen——透過兼容 OpenAI 的 endpoint 進行串流對話補全。

瀏覽模型 →
FAQ

常見問題

相關

探索更多

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

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