可以在 CI 管道中使用吗？

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

可以使用哪些模型？

通过同一个 CLI，RunAPI 提供来自 26 家提供方的 250+ 个模型。

如何验证 CLI 身份？

运行 runapi login，或为 CI 和其他无界面环境导入 RUNAPI_API_KEY。

CLI 支持 Windows 吗？

支持。RunAPI CLI 支持 Windows、macOS 和 Linux，并在可用的平台上提供 amd64 和 arm64 版本。

可以将 CLI 输出通过管道传给其他工具吗？

可以。JSON 输出可以直接通过管道传给 jq、文件、脚本和自动化工具。

Claude 访客：新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次，仅用于 API 用量。

终端 AI 工具

从终端调用 AI 模型

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

免费获取 API Key 在 GitHub 上查看

macOS、Linux、Windows — amd64 和 arm64

Terminal

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

  RunAPI CLI v0.15.0

  Usage: runapi <command> [options]

  Commands:
    login      Authenticate in a browser
    auth       Manage authentication
    account    Read account information
    files      Manage file resources
    pricing    Read schedules and quotes

  Run runapi <command> --help for details

250+

模型

Modalities

<2min

Setup

Install

三种安装方式

curl（Linux / macOS）

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

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

Homebrew

brew install runapi-ai/tap/runapi

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

Go 源码构建

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

使用 Go 1.22+ 从源码构建。

快速开始

几分钟开始使用

Terminal

# 浏览器登录
runapi login

# 或在 CI / 无界面环境导入 token
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -

# 验证
runapi auth status

runapi nano-banana text-to-image --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

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

# 长任务即发即走
TASK_ID=$(runapi suno text-to-music --async --input '{"model":"suno-v5","vocal_mode":"instrumental","style":"minimal piano","title":"Short Piano Theme"}' | jq -r '.id')

# 轮询直到完成
runapi wait "$TASK_ID" --service suno --action text-to-music

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

特性

为开发者打造

JSON 优先输出

每个命令返回结构化 JSON，可通过管道传给 jq、交由脚本处理，或使用任意语言解析。

全模态支持

视频、图像、音乐、音频和 LLM——通过同一个 CLI 调用。使用 --model 参数切换模型。

异步 + 轮询

使用 --async 提交任务后立即返回，再用 runapi wait 轮询结果。专为长时间生成任务设计。

Shell 补全

支持命令、模型名称和参数的 Tab 自动补全，兼容 bash、zsh 和 fish。

适合使用 CLI 的场景

CI/CD 流水线

在构建流程中生成素材。JSON 输出可直接接入脚本和自动化工具。

批量处理

用 Shell 循环处理数百张图片或视频。异步任务管理不会阻塞流程。

快速实验

从终端几秒内测试新模型。无需代码或配置，直接运行 runapi generate。

为什么开发者选择 RunAPI CLI

一个工具，所有模型

不再切换不同提供方的 CLI。一条命令即可调用视频、图像、音乐、音频和 LLM。

适合流水线

支持 JSON 输出、退出码和 stdin，可接入任意 CI/CD 或 Shell 脚本。

内置成本追踪

实时查看每次请求的成本，并按项目设置支出上限。

常见问题

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

探索更多

MCP Server

将 Claude Code、Cursor 等 MCP 兼容 Agent 接入 RunAPI 模型。

SDK

Python、Node.js、PHP、Java、Ruby 和 Go SDK，用于程序化集成。

Skills

为 AI 助手安装预置的模型技能包。

模型目录

浏览全部 250+ 个模型，含定价、参数和代码示例。

需要团队接入支持？

我们可以协助团队接入、完成系统集成并解答技术问题。

联系我们