---
title: "RunAPI CLI — 由你的終端機執行 210+ 個 AI 模型"
url: "https://runapi.ai/zh-HK/cli.md"
canonical: "https://runapi.ai/zh-HK/cli"
locale: "zh-HK"
---

# RunAPI CLI

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

## Install

**curl (Linux / macOS):**

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

**Homebrew:**

```bash
brew install runapi-ai/tap/runapi
```

**Go source build (Go 1.22+):**

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

## Quickstart

```bash
# Authenticate
runapi login

# Generate an image
runapi nano-banana generate \
  --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# Generate music (async)
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate
```

## What Is 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 儲存於本機，驗證一次後即可喺任意目錄執行指令。

## Features

- **JSON-first output** — Every command returns structured JSON for scripts and pipelines.
- **Async + polling** — `--async` flag to fire-and-forget, `runapi wait` to poll.
- **Agent runtime** — Install skills into Claude Code, Codex, Gemini CLI with `runapi agent install-skill`.

## What Can You Generate?

- **圖像生成** — 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

### RunAPI CLI 的費用係幾多？

CLI 本身免費同開源。你只需為 API 呼叫按量付費，無每月最低消費。圖像生成最低每張 $0.02，影片生成最低每段 $0.10，LLM 呼叫按 token 計費，約低於各 provider 官方價格 50%。

### CLI 係咪支援 Claude Code 等 agent runtime？

支援。RunAPI 為 Claude Code、Codex、Gemini CLI 等相容 MCP 的 agent runtime 發布咗可安裝的模型 skill。執行 runapi skill install 即可新增，agent 就可以將 RunAPI 模型當作原生工具使用，唔需要手動設定 API。


## Links

- [Model catalog](https://runapi.ai/zh-HK/models)
- [MCP Server](https://runapi.ai/zh-HK/mcp)
- [SDKs](https://runapi.ai/zh-HK/sdk)
- [Skills](https://runapi.ai/zh-HK/skills)
- [Pricing](https://runapi.ai/zh-HK/pricing)
- [API docs](https://runapi.ai/zh-HK/docs)
- [GitHub](https://github.com/runapi-ai/cli)