CLI RunAPI

Visão Geral

O CLI runapi é a camada de execução para tarefas de modelos RunAPI. Use-o quando um agente precisar gerar imagens, vídeos ou música/áudio com IA, executar um trabalho de modelo único, passar um corpo de requisição JSON, aguardar uma tarefa assíncrona ou automatizar o RunAPI a partir de um terminal, servidor ou job de CI.

Repositório de origem: github.com/runapi-ai/cli-skill (Apache-2.0)

Quando Usar Esta Skill

• Use quando o usuário pedir para executar um modelo RunAPI a partir de um agente.
• Use quando o usuário precisar inspecionar a autenticação ou o status da conta do CLI RunAPI.
• Use quando o usuário quiser passar corpos de requisição JSON para serviços RunAPI.
• Use quando o usuário quiser submeter tarefas assíncronas RunAPI e aguardar a conclusão.
• Use quando o usuário quiser instalar o CLI RunAPI em uma máquina local, servidor ou runner de CI.

Instalar

macOS / Linux

brew install runapi-ai/tap/runapi

Servidor / CI

Baixe o instalador, inspecione-o e execute-o localmente.

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

Para fixar uma versão específica:

sh runapi-install.sh --version v0.1.0

O instalador detecta o SO e a arquitetura, verifica o checksum SHA-256 de https://runapi.ai/cli/latest.json e se recusa a escrever o binário se a verificação falhar.

Autenticação

Trate a autenticação e a geração do RunAPI como sensíveis à segurança: comandos podem chamar serviços remotos, consumir créditos e expor o estado da conta. Revise os scripts do instalador antes de executá-los e mantenha as chaves de API em variáveis de ambiente ou stdin, não no histórico do shell.

Verifique o estado atual primeiro:

runapi auth status

RUNAPI_BASE_URL substitui o URL base padrão.

Evite passar segredos diretamente em argumentos de comando. Prefira RUNAPI_API_KEY ou importação de token via stdin com --token -.

Descobrir Serviços, Comandos e Campos

O CLI é focado em JSON. Cada serviço expõe comandos tipados, e cada comando documenta seus campos de requisição através de --help. Inspecione a ajuda do comando antes de compor uma requisição.

runapi --help
runapi suno --help
runapi suno text-to-music --help

Executar um Modelo

Passe o corpo da requisição como JSON através de --input-file, --input ou stdin. O fluxo padrão é síncrono e faz polling até que a tarefa seja concluída.

runapi suno text-to-music --input-file request.json

runapi suno text-to-music --async --input-file request.json
runapi wait <task-id> --service suno --action text-to-music

runapi get <task-id> --service suno --action text-to-music

Respostas JSON vão para stdout; linhas de progresso vão para stderr. Use pipe para jq para análise downstream.

Conta

runapi account info
runapi account balance

Instalar a Skill em Outro Runtime de Agente

runapi agent install-skill --target claude
runapi agent install-skill --target codex
runapi agent install-skill --target gemini
runapi agent install-skill --target openclaw
runapi agent list-targets
runapi agent install-skill --target-dir <path>

Limitações

• Chamadas de modelos RunAPI exigem uma conta RunAPI válida ou chave de API.
• Algumas tarefas de modelo são de longa duração e devem usar --async mais runapi wait.
• O login no navegador é interativo e não deve ser o caminho padrão para agentes.
• Esta skill não substitui a validação de parâmetros específicos do modelo; inspecione a ajuda do comando antes de construir o JSON da requisição.

Notas de Segurança e Proteção

• Nunca cole chaves de API em exemplos de comandos ou texto de PR.
• Prefira RUNAPI_API_KEY ou importação de token via stdin em vez de segredos na linha de comando.
• Não execute runapi login interativos por padrão a partir de um agente.
• Verifique o código de saída do CLI antes de assumir que uma tarefa foi bem-sucedida.

Referências

• Skill CLI RunAPI: https://github.com/runapi-ai/cli-skill
• Repositório CLI RunAPI: https://github.com/runapi-ai/cli
• Catálogo de modelos RunAPI: https://runapi.ai/models.md