Come installo la CLI di RunAPI?

Tre opzioni: curl -fsSL https://runapi.ai/cli/install.sh | sh (rileva automaticamente OS e architettura), brew install runapi-ai/tap/runapi (Homebrew), oppure go install github.com/runapi-ai/cli/cmd/runapi@latest (build da sorgenti Go).

Quali piattaforme supporta la CLI?

macOS e Linux, sia su architetture amd64 che arm64. Lo script di installazione curl rileva automaticamente sistema operativo e CPU, verifica un checksum SHA-256 e scrive il binario in /usr/local/bin.

Posso usare la CLI nelle pipeline CI?

Sì. Usa l’installer curl nella tua pipeline CI/CD e imposta RUNAPI_API_KEY come variabile d’ambiente. La CLI supporta l’autenticazione headless tramite runapi auth import-token per ambienti non interattivi.

Quali modelli AI posso eseguire dalla CLI?

Oltre 130 modelli di 18 provider: Suno per la musica, Kling e Veo per i video, Flux e Nano Banana per le immagini, ElevenLabs per l’audio e Claude, GPT, Gemini, DeepSeek per gli LLM.

Come funziona la gestione dei task asincroni?

Usa il flag --async per un’esecuzione fire-and-forget. La CLI restituisce subito un task ID. Poi usa runapi wait TASK_ID per eseguire il polling fino al completamento. L’output JSON rende facile estrarre i task ID con jq.

CLI

RunAPI CLI.
Modelli AI nel tuo terminale.

Un solo binario chiama oltre 130 modelli AI — Suno, Veo, Kling, Flux, Claude, GPT e altri — con output JSON-first che si integra perfettamente con script, pipeline CI e runtime agentici.

Ottieni una chiave API gratuita Vedi su GitHub

macOS, Linux — amd64 e arm64

Quickstart

runapi

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

# Autentica
runapi login

# Genera un'immagine
runapi nano-banana generate \
  --input '{"prompt":"a hummingbird drinking espresso"}'

# Genera musica (fire-and-forget, poi fai polling)
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

Un solo binario, oltre 130 modelli. Output JSON-first per script e pipeline.

INSTALL

Tre modi per installarlo

curl (Linux / macOS)

Rileva automaticamente sistema operativo e architettura, verifica il checksum SHA-256, scrive in /usr/local/bin.

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

Homebrew

Tap ufficiale di Homebrew. Aggiornamenti automatici con brew upgrade.

brew install runapi-ai/tap/runapi

Build da sorgenti Go

Compila da sorgenti con Go 1.22+.

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

QUICKSTART

Inizia a sviluppare in pochi minuti

Autenticati, poi genera.

# Accesso dal browser (laptop)
runapi login

# Oppure importa un token (CI / headless)
printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -

# Verifica
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 per job lunghi
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"upbeat indie rock about coding"}' | jq -r .id)

# Fai polling fino al completamento
runapi wait "$TASK_ID" --service suno --action generate

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

FEATURES

Pensato per sviluppatori

Output JSON-first

Ogni comando restituisce JSON strutturato — usa pipe con jq, alimenta gli script, fai parsing in qualsiasi linguaggio.

Async + polling

Esegui in fire-and-forget con --async, poi fai polling con runapi wait. Pensato per task di generazione a lunga durata.

Runtime per agenti

Installa le skill della CLI in Claude Code, Codex, Gemini CLI e altri runtime per agenti con un solo comando.

FAQ

Domande frequenti

Pronto a eseguire modelli AI dal tuo terminale?

Installa la CLI e inizia a generare in pochi minuti.

Ottieni una chiave API gratuita

RunAPI CLI.Modelli AI nel tuo terminale.