How do I install the RunAPI CLI?

Three options: curl -fsSL https://runapi.ai/cli/install.sh | sh (auto-detects OS and arch), brew install runapi-ai/tap/runapi (Homebrew), or go install github.com/runapi-ai/cli/cmd/runapi@latest (Go source build).

What platforms does the CLI support?

macOS and Linux on both amd64 and arm64 architectures. The curl install script auto-detects your OS and CPU, verifies a SHA-256 checksum, and writes the binary to /usr/local/bin.

Can I use the CLI in CI pipelines?

Yes. Use the curl installer in your CI/CD pipeline and set RUNAPI_API_KEY as an environment variable. The CLI supports headless authentication via runapi auth import-token for non-interactive environments.

What AI models can I run from the CLI?

Over 130 models across 18 providers: Suno for music, Kling and Veo for video, Flux and Nano Banana for images, ElevenLabs for audio, and Claude, GPT, Gemini, DeepSeek for LLMs.

How does async task handling work?

Use the --async flag to fire-and-forget. The CLI returns a task ID immediately. Then use runapi wait TASK_ID to poll until completion. JSON output makes it easy to extract task IDs with jq.

CLI

RunAPI CLI.
AI Models in Your Terminal.

One binary calls 130+ AI models — Suno, Veo, Kling, Flux, Claude, GPT, and the rest — with JSON-first output that maps cleanly to scripts, CI pipelines, and agent runtimes.

Get Free API Key GitHub

macOS, Linux — amd64 and 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.

INSTALL

Three Ways to Install

curl (Linux / macOS)

Auto-detects OS and architecture, verifies SHA-256 checksum, writes to /usr/local/bin.

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

Homebrew

Official Homebrew tap. Auto-updates with brew upgrade.

brew install runapi-ai/tap/runapi

Go Source Build

Build from source with Go 1.22+.

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

QUICKSTART

Start Building in Minutes

Authenticate, then generate.

# 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

FEATURES

Built for Developers

JSON-First Output

Every command returns structured JSON — pipe to jq, feed to scripts, parse in any language.

Async + Polling

Fire-and-forget with --async, then poll with runapi wait. Built for long-running generation tasks.

Agent Runtime

Install CLI skills into Claude Code, Codex, Gemini CLI, and other agent runtimes with one command.

FAQ

Frequently Asked Questions

Ready to run AI models from your terminal?

Install the CLI and start generating in minutes.

Get Free API Key

RunAPI CLI.AI Models in Your Terminal.