curl (Linux / macOS)
curl -fsSL https://runapi.ai/cli/install.sh | sh
Detects OS/arch and verifies SHA-256.
CLI
AI Models from Your Terminal
One binary calls 250+ 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.
macOS, Linux, Windows — amd64 and arm64
Terminal
$ curl -fsSL https://runapi.ai/cli/install.sh | sh
RunAPI CLI v0.14.1
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 details250+
Models
5
Modalities
<2min
Setup
Install
One Command to Start
Homebrew
brew install runapi-ai/tap/runapi
Official Homebrew tap. Upgrade with brew.
Go Source Build
go install github.com/runapi-ai/cli/cmd/runapi@latest
Build from source with Go 1.22+.
QUICKSTART
Generate Your First Video in 30 Seconds
Terminal
# 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 statusrunapi nano-banana text-to-image --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'
# { "id": "task_id", "status": "completed", "output": { ... } }# Fire-and-forget for long jobs
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')
# Poll until completion
runapi wait "$TASK_ID" --service suno --action text-to-musicFEATURES
Built for Developer Workflows
JSON Output
Every command returns structured JSON. Pipe results to jq, save to files, or feed into scripts.
All Modalities
Video, image, music, audio, and LLM — one CLI for everything. Switch models with --model flag.
Async by Default
Long tasks return immediately with a task ID. Poll with runapi task or use --wait to block.
Shell Completion
Tab completion for commands, model names, and flags. Supports bash, zsh, and fish.
Where the CLI Shines
CI/CD Pipelines
Generate assets as part of your build process. JSON output pipes cleanly into scripts and automation tools.
Batch Processing
Process hundreds of images or videos with a shell loop. Async task management means no blocking.
Quick Experiments
Test a new model in seconds from your terminal. No code, no setup — just runapi generate.
Why developers choose RunAPI CLI
One Tool, All Models
Stop switching between provider CLIs. One command for video, image, music, audio, and LLM.
Pipeline-Friendly
JSON output, exit codes, and stdin support. Drops into any CI/CD or shell script.
Built-in Cost Tracking
See per-request costs in real time. Set spending limits per project.
CLI questions
Use the curl installer for macOS or Linux, Homebrew on macOS, or build from source with Go 1.22+.
Yes. Set RUNAPI_API_KEY in the environment and use JSON output in scripts.
RunAPI exposes 250+ models across 26 providers through the same CLI.
Run runapi login, or import RUNAPI_API_KEY for CI and other headless environments.
Yes. RunAPI CLI supports Windows, macOS, and Linux on amd64 and arm64 where available.
Yes. JSON output pipes directly to jq, files, scripts, and automation tools.
Explore more
Building with a team?
We're here to help with enterprise setup, integrations, and technical questions.