---
title: "RunAPI CLI — Ejecuta más de 130 modelos de IA desde tu terminal"
url: "https://runapi.ai/es/cli.md"
canonical: "https://runapi.ai/es/cli"
locale: "es"
---

# RunAPI CLI

Un binario llama a más de 130 modelos de IA — Suno, Veo, Kling, Flux, Claude, GPT y el resto — con salida JSON nativa que se integra limpiamente en scripts, pipelines de CI y runtimes de agentes.

## 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 es un único binario Go que llama a más de 130 modelos de IA de 18 proveedores a través de una API unificada. En lugar de instalar SDK separados para Suno, Kling, Flux, Claude y GPT, ejecutas un solo comando — runapi <service> <action> — y obtienes JSON estructurado de vuelta. Gestiona autenticación, polling asíncrono y formateo de salida para que tus scripts de shell, pipelines de CI y runtimes de agentes se mantengan limpios. Cada solicitud se factura por llamada sin mínimo mensual, y el CLI almacena tu API key localmente — autentícate una vez y ejecuta comandos desde cualquier directorio.

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

- **Generación de imágenes** — Flux, Nano Banana, Recraft, Ideogram, Seedream, GPT Image, Imagen 4 — genera y edita imágenes a partir de prompts de texto.
- **Generación de vídeo** — Kling, Veo, Runway, Luma, Hailuo, Wan, Seedance — generación de texto a vídeo con polling asíncrono integrado.
- **Música y audio** — Suno para música, ElevenLabs para texto a voz y clonación de voz, InfiniteTalk para avatares parlantes.
- **Chat LLM y completion** — Claude, GPT, Gemini, DeepSeek, Grok, Qwen — completions de chat en streaming vía el endpoint compatible con OpenAI.

## FAQ

### ¿Cómo instalo el CLI de RunAPI?

Tres opciones: curl -fsSL https://runapi.ai/cli/install.sh | sh (detecta automáticamente el SO y la arquitectura), brew install runapi-ai/tap/runapi (Homebrew), o go install github.com/runapi-ai/cli/cmd/runapi@latest (compilación desde código fuente con Go).

### ¿Qué plataformas soporta el instalador con curl?

macOS y Linux en arquitecturas amd64 y arm64. El script de instalación con curl detecta automáticamente tu SO y CPU, verifica el checksum SHA-256 y escribe el binario en /usr/local/bin.

### ¿Puedo usar el CLI en pipelines de CI?

Sí. Usa el instalador curl en tu pipeline CI/CD y define RUNAPI_API_KEY como variable de entorno. El CLI soporta autenticación sin interfaz mediante runapi auth import-token para entornos no interactivos.

### ¿Qué modelos de IA puedo ejecutar desde el CLI?

Más de 130 modelos de 18 proveedores: Suno para música, Kling y Veo para vídeo, Flux y Nano Banana para imágenes, ElevenLabs para audio, y Claude, GPT, Gemini, DeepSeek para LLMs.

### ¿Cómo funciona la gestión de tareas asíncronas?

Usa el flag --async para enviar y olvidar. El CLI devuelve inmediatamente un ID de tarea. Luego usa runapi wait TASK_ID para consultar hasta que finalice. La salida en JSON facilita extraer IDs de tarea con jq.

### ¿Cuánto cuesta el CLI de RunAPI?

El CLI en sí es gratuito y de código abierto. Solo pagas por las llamadas a la API bajo demanda, sin mínimo mensual. La generación de imágenes empieza desde 0,02 $ por imagen, la generación de vídeo desde 0,10 $ por clip, y las llamadas a LLM se facturan por token a aproximadamente un 50 % por debajo del precio oficial de cada proveedor.

### ¿Funciona el CLI con runtimes de agentes como Claude Code?

Sí. RunAPI publica skills de modelos instalables para Claude Code, Codex, Gemini CLI y otros runtimes de agentes compatibles con MCP. Ejecuta runapi skill install para añadir un skill de modelo — el agente podrá entonces llamar a los modelos de RunAPI como herramientas nativas sin configuración manual de API.


## Links

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