---
title: "RunAPI CLI — 终端 AI 工具，一行命令调用 130+ 大模型和生成 API"
url: "https://runapi.ai/zh-CN/cli.md"
canonical: "https://runapi.ai/zh-CN/cli"
locale: "zh-CN"
---

# RunAPI CLI

一行命令调用 130+ AI 模型——Claude、GPT、Gemini 大模型，Kling、Veo 生视频，Suno 生音乐，Flux、GPT Image 生图。JSON 输出，适配脚本、CI 和 Agent 工作流。

## 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 调用 18 个提供方的 130+ 个 AI 模型。无需分别为 Suno、Kling、Flux、Claude、GPT 安装不同 SDK，只需一条命令——runapi <service> <action>——即可获得结构化 JSON 输出。它内置认证、异步轮询和输出格式化，让你的 Shell 脚本、CI 流水线和 Agent 工作流保持简洁。每次请求按量计费、无月付最低消费，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 的端点进行流式对话补全。

## FAQ

### RunAPI CLI 的费用是多少？

CLI 本身免费且开源。你只需为 API 调用按量付费，无月付最低消费。图像生成最低每张 $0.02，视频生成最低每段 $0.10，LLM 调用按 token 计费，约低于各提供方官方价格的 50%。

### CLI 是否支持 Claude Code 等 Agent 运行时？

支持。RunAPI 为 Claude Code、Codex、Gemini CLI 等兼容 MCP 的 Agent 运行时发布了可安装的模型 skill。运行 runapi skill install 即可添加，Agent 即可将 RunAPI 模型作为原生工具使用，无需手动配置 API。


## Links

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