---
title: "RunAPI CLI — Execute 130+ Modelos de IA no Seu Terminal"
url: "https://runapi.ai/pt-BR/cli.md"
canonical: "https://runapi.ai/pt-BR/cli"
locale: "pt-BR"
---

# RunAPI CLI

Um binário chama 130+ modelos de IA — Suno, Veo, Kling, Flux, Claude, GPT, e o resto — com saída JSON que se integra perfeitamente a scripts, pipelines de CI e 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?

O RunAPI CLI é um único binário Go que chama 130+ modelos de IA de 18 provedores por uma API unificada. Em vez de instalar SDKs separados para Suno, Kling, Flux, Claude e GPT, você executa um comando — runapi <service> <action> — e recebe JSON estruturado de volta. Ele gerencia autenticação, polling assíncrono e formatação de saída para que seus scripts, pipelines de CI e runtimes de agentes fiquem limpos. Cada requisição é cobrada por chamada sem mínimo mensal, e o CLI armazena sua chave de API localmente para que você autentique uma vez e execute comandos de qualquer diretório.

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

- **Geração de Imagens** — Flux, Nano Banana, Recraft, Ideogram, Seedream, GPT Image, Imagen 4 — gere e edite imagens a partir de prompts de texto.
- **Geração de Vídeo** — Kling, Veo, Runway, Luma, Hailuo, Wan, Seedance — geração de texto para vídeo com polling assíncrono integrado.
- **Música e Áudio** — Suno para música, ElevenLabs para text-to-speech e clonagem de voz, InfiniteTalk para avatares falantes.
- **Chat LLM e Completion** — Claude, GPT, Gemini, DeepSeek, Grok, Qwen — completions de chat em streaming via endpoint compatível com OpenAI.

## FAQ

### Como instalo o RunAPI CLI?

Três opções: curl -fsSL https://runapi.ai/cli/install.sh | sh (detecta automaticamente o SO e a arquitetura), brew install runapi-ai/tap/runapi (Homebrew), ou go install github.com/runapi-ai/cli/cmd/runapi@latest (build do código-fonte com Go).

### Quais plataformas o instalador via curl suporta?

macOS e Linux em arquiteturas amd64 e arm64. O script de instalação via curl detecta automaticamente seu SO e CPU, verifica um checksum SHA-256 e salva o binário em /usr/local/bin.

### Posso usar o CLI em pipelines de CI?

Sim. Use o instalador via curl no seu pipeline de CI/CD e defina RUNAPI_API_KEY como variável de ambiente. O CLI suporta autenticação headless via runapi auth import-token para ambientes não interativos.

### Quais modelos de IA posso executar pelo CLI?

Mais de 130 modelos em 18 provedores: Suno para música, Kling e Veo para vídeo, Flux e Nano Banana para imagens, ElevenLabs para áudio, e Claude, GPT, Gemini, DeepSeek para LLMs.

### Como funciona o gerenciamento de tarefas assíncronas?

Use a flag --async para disparar e esquecer. O CLI retorna um ID de tarefa imediatamente. Depois use runapi wait TASK_ID para verificar até concluir. A saída em JSON facilita extrair IDs de tarefas com jq.

### Quanto custa o RunAPI CLI?

O CLI em si é gratuito e open source. Você paga apenas pelas chamadas de API por requisição, sem mínimo mensal. Geração de imagens começa em $0,02 por imagem, geração de vídeo a partir de $0,10 por clipe, e chamadas LLM são cobradas por token a aproximadamente 50% abaixo dos preços oficiais dos provedores.

### O CLI funciona com runtimes de agentes como Claude Code?

Sim. O RunAPI publica skills de modelos instaláveis para Claude Code, Codex, Gemini CLI e outros runtimes de agentes compatíveis com MCP. Execute runapi skill install para adicionar um skill de modelo; o agente pode então chamar modelos RunAPI como ferramentas nativas sem configuração manual de API.


## Links

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