---
title: "RunAPI CLI — Esegui oltre 130 modelli AI dal tuo terminale"
url: "https://runapi.ai/it/cli.md"
canonical: "https://runapi.ai/it/cli"
locale: "it"
---

# RunAPI CLI

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.

## Install

**curl (Linux / macOS):**

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

**Homebrew:**

```bash
brew install runapi-ai/tap/runapi
```

**Go source build (Go 1.22+):**

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

## Quickstart

```bash
# Authenticate
runapi login

# Generate an image
runapi nano-banana generate \
  --input '{"prompt":"a hummingbird drinking espresso","aspect_ratio":"1:1"}'

# Generate music (async)
TASK_ID=$(runapi suno generate --async \
  --input '{"prompt":"indie rock about coding"}' | jq -r .id)
runapi wait "$TASK_ID" --service suno --action generate
```

## What Is RunAPI CLI?

RunAPI CLI è un singolo binario Go che chiama oltre 130 modelli AI di 18 provider tramite un'unica API unificata. Invece di installare SDK separati per Suno, Kling, Flux, Claude e GPT, esegui un solo comando — runapi <service> <action> — e ottieni JSON strutturato in risposta. Gestisce autenticazione, polling asincrono e formattazione dell'output così che i tuoi script shell, pipeline CI e runtime per agenti rimangano puliti. Ogni richiesta viene fatturata per chiamata senza un minimo mensile, e la CLI salva la tua API key in locale — autenticati una volta e lancia comandi da qualsiasi directory.

## Features

- **JSON-first output** — Every command returns structured JSON for scripts and pipelines.
- **Async + polling** — `--async` flag to fire-and-forget, `runapi wait` to poll.
- **Agent runtime** — Install skills into Claude Code, Codex, Gemini CLI with `runapi agent install-skill`.

## What Can You Generate?

- **Generazione di immagini** — Flux, Nano Banana, Recraft, Ideogram, Seedream, GPT Image, Imagen 4 — genera e modifica immagini da prompt testuali.
- **Generazione video** — Kling, Veo, Runway, Luma, Hailuo, Wan, Seedance — generazione testo-in-video con polling asincrono integrato.
- **Musica e audio** — Suno per la musica, ElevenLabs per text-to-speech e clonazione vocale, InfiniteTalk per avatar parlanti.
- **Chat LLM e completion** — Claude, GPT, Gemini, DeepSeek, Grok, Qwen — chat completion in streaming tramite l'endpoint compatibile OpenAI.

## FAQ

### 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.

### Quanto costa la CLI di RunAPI?

La CLI stessa è gratuita e open source. Paghi solo per le chiamate API in base all’utilizzo, senza un minimo mensile. La generazione di immagini parte da 0,02 $ per immagine, la generazione video da 0,10 $ per clip, e le chiamate LLM vengono fatturate per token a circa il 50% in meno rispetto ai prezzi ufficiali dei provider.

### La CLI funziona con runtime per agenti come Claude Code?

Sì. RunAPI pubblica skill di modelli installabili per Claude Code, Codex, Gemini CLI e altri runtime per agenti compatibili con MCP. Esegui runapi skill install per aggiungere una skill di modello — l’agente potrà poi chiamare i modelli RunAPI come strumenti nativi senza configurazione API manuale.


## Links

- [Model catalog](https://runapi.ai/it/models)
- [MCP Server](https://runapi.ai/it/mcp)
- [SDKs](https://runapi.ai/it/sdk)
- [Skills](https://runapi.ai/it/skills)
- [Pricing](https://runapi.ai/it/pricing)
- [API docs](https://runapi.ai/it/docs)
- [GitHub](https://github.com/runapi-ai/cli)