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

# RunAPI CLI

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

## 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 單一執行檔，透過統一 API 呼叫 23 個 provider 的 210+ 個 AI 模型。你不需要分別為 Suno、Kling、Flux、Claude、GPT 安裝不同的 SDK，只要一條指令——runapi <service> <action>——就能取得結構化 JSON 輸出。它內建驗證、非同步輪詢與輸出格式化，讓你的 shell script、CI pipeline 與 agent runtime 保持整潔。每次請求按量計費、無每月最低消費，API 金鑰儲存於本機，驗證一次後即可在任意目錄執行指令。

## 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-TW/models)
- [MCP Server](https://runapi.ai/zh-TW/mcp)
- [SDKs](https://runapi.ai/zh-TW/sdk)
- [Skills](https://runapi.ai/zh-TW/skills)
- [Pricing](https://runapi.ai/zh-TW/pricing)
- [API docs](https://runapi.ai/zh-TW/docs)
- [GitHub](https://github.com/runapi-ai/cli)