终端里的
AI API 中转站
一行命令调用 130+ AI 模型——Claude、GPT、Gemini 大模型，Kling、Veo 生视频，Suno 生音乐，Flux、GPT Image 生图。JSON 输出，适配脚本、CI 和 Agent 工作流。
# 安装
curl -fsSL https://runapi.ai/cli/install.sh | sh
# 认证
runapi login
# 生成图像
runapi nano-banana generate \
--input '{"prompt":"a hummingbird drinking espresso"}'
# 生成音乐并轮询结果
TASK_ID=$(runapi suno generate --async \
--input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate什么是 RunAPI CLI？
RunAPI CLI 是一个 Go 单二进制文件，通过一套统一 API 调用 18 个提供方的 130+ 个 AI 模型。无需分别为 Suno、Kling、Flux、Claude、GPT 安装不同 SDK，只需一条命令——runapi <service> <action>——即可获得结构化 JSON 输出。它内置认证、异步轮询和输出格式化，让你的 Shell 脚本、CI 流水线和 Agent 工作流保持简洁。每次请求按量计费、无月付最低消费，API Key 本地存储，认证一次后可在任意目录执行命令。
三种安装方式
curl（Linux / macOS）
自动检测操作系统和架构，验证 SHA-256 校验和，写入 /usr/local/bin。
curl -fsSL https://runapi.ai/cli/install.sh | shHomebrew
官方 Homebrew tap，通过 brew upgrade 自动更新。
brew install runapi-ai/tap/runapiGo 源码构建
使用 Go 1.22+ 从源码构建。
go install github.com/runapi-ai/cli/cmd/runapi@latest几分钟开始使用
先认证，然后调用图像生成、视频生成或 AI 音乐生成。
# 浏览器登录
runapi login
# 或在 CI / 无界面环境导入 token
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -
# 验证
runapi auth statusrunapi 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为开发者打造
JSON 优先输出
每个命令返回结构化 JSON — 管道到 jq、输入到脚本、用任何语言解析。
异步 + 轮询
使用 --async 即发即走，然后用 runapi wait 轮询。专为长时间生成任务设计。
Agent 运行时
一个命令将 CLI 技能安装到 Claude Code、Codex、Gemini CLI 和其他 Agent 运行时。
可以生成什么？
常见问题
CLI 本身免费且开源。你只需为 API 调用按量付费，无月付最低消费。图像生成最低每张 $0.02，视频生成最低每段 $0.10，LLM 调用按 token 计费，约低于各提供方官方价格的 50%。
支持。RunAPI 为 Claude Code、Codex、Gemini CLI 等兼容 MCP 的 Agent 运行时发布了可安装的模型 skill。运行 runapi skill install 即可添加，Agent 即可将 RunAPI 模型作为原生工具使用，无需手动配置 API。