如何安装 RunAPI CLI？

三种方式：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 源码构建）。

CLI 支持哪些平台？

macOS 和 Linux，支持 amd64 和 arm64 架构。curl 安装脚本自动检测操作系统和 CPU，验证 SHA-256 校验和，写入 /usr/local/bin。

可以在 CI 管道中使用吗？

可以。在 CI/CD 管道中使用 curl 安装脚本并设置 RUNAPI_API_KEY 环境变量。CLI 支持通过 runapi auth import-token 进行无界面认证。

可以运行哪些 AI 模型？

130+ 模型，18 个提供方：Suno（音乐）、Kling 和 Veo（视频）、Flux 和 Nano Banana（图像）、ElevenLabs（音频）、Claude、GPT、Gemini、DeepSeek（LLM）。

异步任务如何工作？

使用 --async 标志即发即走，CLI 立即返回任务 ID。然后使用 runapi wait TASK_ID 轮询直到完成。JSON 输出便于用 jq 提取任务 ID。

CLI

RunAPI CLI。
终端中的 AI 模型。

一个命令行工具调用 130+ AI 模型 — Suno、Veo、Kling、Flux、Claude、GPT 等 — JSON 优先输出，完美适配脚本、CI 流水线和 Agent 运行时。

免费获取 API Key GitHub

macOS、Linux — amd64 和 arm64

Quickstart

runapi

# Install
curl -fsSL https://runapi.ai/cli/install.sh | sh

# Authenticate
runapi login

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

# Generate music (fire-and-forget, then poll)
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

One binary, 130+ models. JSON-first output for scripts and pipelines.

安装

三种安装方式

curl（Linux / macOS）

自动检测操作系统和架构，验证 SHA-256 校验和，写入 /usr/local/bin。

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

Homebrew

官方 Homebrew tap，通过 brew upgrade 自动更新。

brew install runapi-ai/tap/runapi

Go 源码构建

使用 Go 1.22+ 从源码构建。

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

快速开始

几分钟开始使用

先认证，然后生成。

# Browser-based login (laptop)
runapi login

# Or import a token (CI / headless)
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -

# Verify
runapi auth status

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

# { "id": "task_abc123", "status": "completed", "output": { ... } }

# Fire-and-forget for long jobs
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"upbeat indie rock about coding"}' | jq -r .id)

# Poll until completion
runapi wait "$TASK_ID" --service suno --action generate

runapi <service> <action> --input '{...}' JSON

特性

为开发者打造

JSON 优先输出

每个命令返回结构化 JSON — 管道到 jq、输入到脚本、用任何语言解析。

异步 + 轮询

使用 --async 即发即走，然后用 runapi wait 轮询。专为长时间生成任务设计。

Agent 运行时

一个命令将 CLI 技能安装到 Claude Code、Codex、Gemini CLI 和其他 Agent 运行时。

常见问题

准备从终端运行 AI 模型？

安装 CLI，几分钟内开始生成。

免费获取 API Key

RunAPI CLI。终端中的 AI 模型。