Uma chave substitui quatro
Configure a RunAPI uma vez no OpenClaw e os quatro tipos de ferramentas funcionam: chat, image_generate, video_generate e music_generate. Sem habilidades extras, sem plugins ComfyUI, sem serviços intermediários para Suno.
BEST API FOR OPENCLAW
Melhor API para OpenClaw: Uma Chave para LLM, Imagem, Vídeo e Música
O OpenClaw suporta chat, image_generate, video_generate e music_generate — mas a maioria dos provedores de API cobre apenas um ou dois. A RunAPI cobre os quatro com uma chave, 113+ modelos de 18 provedores e pagamento por uso a partir de 2 centavos por chamada.
Atualizado em June 11, 2026
RunAPI Editorial Team
Configure RunAPI as an API provider in this OpenClaw workspace.
- Add a provider named "runapi" with baseUrl "https://runapi.ai/v1".
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Use api "openai-completions".
- Register model id "gpt-5.5" with display name "RunAPI GPT 5.5".
- Set the default model to "runapi/gpt-5.5" while keeping existing providers available.
- After editing config, run `openclaw models status` and confirm `runapi/gpt-5.5` appears.
- If RUNAPI_API_KEY is missing, ask me to set it before starting OpenClaw.
Sign up at https://runapi.ai to get your API key.QUICK ANSWER
O que torna um provedor de API a melhor opção para OpenClaw?
Agentes OpenClaw usam quatro tipos de ferramentas: chat para LLM, image_generate, video_generate e music_generate. Um provedor que cobre apenas LLM deixa três ferramentas sem configuração. Um provedor que cobre apenas imagens ainda deixa duas lacunas. A RunAPI é o único provedor de chave única que preenche os quatro com 113+ modelos, então você configura uma baseUrl e uma chave de API em vez de gerenciar credenciais para quatro serviços separados.
LLM: 20+ modelos de chat
Claude, GPT, Gemini, DeepSeek e mais via endpoint /v1/chat/completions compatível com OpenAI. Respostas em streaming ou saída síncrona.
Imagem: 30+ modelos de geração
Flux Kontext, Nano Banana, GPT Image, Imagen 4, Seedream, Ideogram e outros. Texto para imagem, imagem para imagem, edição, remix, upscale e remoção de fundo.
Vídeo: 25+ modelos de geração
Kling, Veo, Seedance, Hailuo, Wan, Runway e Luma. Texto para vídeo, imagem para vídeo e edição de vídeo com consulta de tarefa assíncrona.
Música: acesso à API do Suno
Suno v4, v4.5, v4.5-plus, v5 e v5.5 via API direta. Modo personalizado, extensão, remix e geração de letras sem serviços intermediários.
WHAT SETS RUNAPI APART
Por que desenvolvedores OpenClaw escolhem RunAPI em vez de APIs de provedor único
Tutoriais do OpenClaw mostram desenvolvedores usando Replicate para imagens (US$1 por 28 gerações), um provedor LLM separado e pontes para música. Cada provedor significa uma chave de API separada, um painel de cobrança separado e um ponto de falha separado. A RunAPI consolida tudo isso em um único ponto de integração.
A troca de modelos reduz custos
Desenvolvedores executando agentes OpenClaw reduzem suas faturas mensais de API de US$1.000 para US$1 roteando tarefas rotineiras para modelos mais baratos. O catálogo de 113+ modelos da RunAPI aplica a mesma estratégia a todas as quatro modalidades.
Endpoint compatível com OpenAI
O OpenClaw já suporta provedores personalizados compatíveis com OpenAI. Aponte baseUrl para https://runapi.ai/v1, defina a chave de API e todos os modelos do catálogo da RunAPI ficam disponíveis sem código de habilidade personalizado.
Pagamento por uso, sem assinatura
Sem mínimos mensais, sem créditos que expiram, sem planos escalonados. Você paga apenas pelo que seu agente OpenClaw realmente gera. Adicione créditos quando precisar, pare de gastar quando não precisar.
DECISION TABLE
Qual provedor de API se encaixa em cada caso de uso do OpenClaw?
| Necessidade | Melhor opção | Por quê |
|---|---|---|
| Apenas chat LLM, sem geração de mídia | OpenAI ou RunAPI | Ambos funcionam como provedores compatíveis com OpenAI. A RunAPI adiciona variedade de modelos e opções de menor custo. |
| Geração de imagens em agentes OpenClaw | RunAPI | 30+ modelos de imagem por um endpoint. Sem instalação de habilidades extras ou configuração de ComfyUI necessária. |
| Geração de vídeo em agentes OpenClaw | RunAPI | 25+ modelos de vídeo incluindo Kling, Veo e Seedance. Nenhum outro provedor de chave única cobre vídeo com essa profundidade. |
| Geração de música em agentes OpenClaw | RunAPI | Acesso direto à API do Suno sem serviços intermediários. Outros provedores não oferecem geração de música. |
| Todas as quatro modalidades com uma chave | RunAPI | O único provedor que cobre LLM, imagem, vídeo e música por uma chave de API e uma conta de cobrança. |
| Geração de imagens ao menor custo possível | Runware ou RunAPI | Runware oferece 1.670 imagens por dólar. A RunAPI compete em amplitude: imagens mais vídeo, música e LLM em uma chave. |
PROVIDER COMPARISON
RunAPI vs OpenAI vs fal.ai vs Replicate vs OpenRouter
| Dimensão | RunAPI | OpenAI | fal.ai | Replicate | OpenRouter |
|---|---|---|---|---|---|
| Modelos LLM | 20+ modelos: Claude, GPT, Gemini, DeepSeek. Endpoint compatível com OpenAI. | Apenas modelos GPT. API nativa. | Sem modelos LLM. Apenas imagem e vídeo. | Alguns modelos LLM. Não compatível com OpenAI. | 100+ modelos LLM. Compatível com OpenAI. Sem geração de mídia. |
| Modelos de imagem | 30+ modelos: Flux, Nano Banana, GPT Image, Imagen 4, Seedream, Ideogram, Recraft. | Apenas GPT Image. | 20+ modelos: Flux, Stable Diffusion e modelos da comunidade. | Grande biblioteca de modelos. US$1 por 28 imagens em alguns modelos. | Sem geração de imagens. |
| Modelos de vídeo | 25+ modelos: Kling, Veo, Seedance, Hailuo, Wan, Runway, Luma. | Sem geração de vídeo. | Modelos de vídeo limitados. | Alguns modelos de vídeo. Custo por geração mais alto. | Sem geração de vídeo. |
| Modelos de música | Suno v4 até v5.5. Modo personalizado, extensão, remix, letras. | Sem geração de música. | Sem geração de música. | Sem geração de música. | Sem geração de música. |
| Modelo de preços | Pagamento por uso. Sem assinatura. Sem créditos que expiram. | Pagamento por uso. Custo por chamada mais alto na maioria dos modelos. | Pagamento por uso. Preços de imagem competitivos a ~4 centavos por imagem. | Pagamento por segundo de computação. Custos variam muito por modelo. | Pagamento por uso. Apenas LLM. |
| Compatível com OpenAI | Sim. /v1/chat/completions funciona com OpenClaw sem configuração adicional. | Sim. API nativa OpenAI. | Não. API REST personalizada. | Não. API REST personalizada. | Sim. /v1/chat/completions. Apenas LLM. |
| Nível gratuito | Cadastro gratuito. Pagamento por uso a partir da primeira chamada. | Nível gratuito com créditos limitados para novas contas. | Nível gratuito com créditos mensais limitados. | Nível gratuito com segundos de computação limitados. | Nível gratuito com créditos limitados em modelos selecionados. |
PRODUCTION CHECKLIST
O que verificar antes de executar agentes OpenClaw em produção
Uma demo funcionando não é um deploy em produção. Essas quatro verificações previnem os modos de falha mais comuns que desenvolvedores OpenClaw enfrentam após a primeira semana: contas inesperadas, chamadas de ferramentas quebradas, tratamento de erros ausente e vazamento de credenciais.
Credenciais
Armazene a chave de API em uma variável de ambiente
Defina RUNAPI_API_KEY no seu perfil de shell ou nos segredos de CI. Nunca cole chaves de API na janela de contexto do OpenClaw nem as comite no controle de versão. A configuração do OpenClaw lê ${RUNAPI_API_KEY} em tempo de execução.
Controle de custos
Roteie tarefas por custo de modelo
Use modelos mais baratos como gpt-5.4-mini para revisões de código rotineiras e reserve modelos premium para raciocínio complexo. A mesma estratégia se aplica a imagens: use modelos rápidos para rascunhos e modelos pro para a saída final.
Tratamento de erros
Trate respostas 402 e 429
Um 402 significa créditos insuficientes. Um 429 significa limite de taxa. Ambos são recuperáveis. Configure o OpenClaw para tentar novamente no 429 com backoff e alertar no 402 para que você possa adicionar créditos antes que o agente pare.
Monitoramento
Acompanhe o gasto por modalidade
Use o painel da RunAPI para monitorar o gasto diário por modelo e endpoint. Defina alertas de orçamento antes de uma sessão de agente longa. Revise o detalhamento de uso semanalmente para encontrar oportunidades de otimização de custos.
USE CASE GUIDE
Assistente de codificação IA com geração de imagens
Agentes OpenClaw que geram mockups de UI, fotos de produto ou diagramas junto com código. Roteie chamadas à ferramenta image_generate para Flux Kontext, Nano Banana ou GPT Image via RunAPI.
Guia de geração de imagensAgente de conteúdo com vídeo e música
Workflows OpenClaw que produzem vídeos de marketing, clipes sociais ou música de fundo para apresentações. Roteie video_generate para Kling ou Veo, e music_generate para Suno.
Comparativo de API de vídeoOtimização de custos com múltiplos modelos
Agentes que alternam entre modelos baratos e premium baseados na complexidade da tarefa. Use gpt-5.4-mini para tarefas simples, gpt-5.5 para raciocínio complexo e flux-kontext-pro para imagens, tudo com uma chave de API.
Ver preçosAPI EXAMPLES
Quatro modalidades, uma chave de API, uma configuração OpenClaw
Esses são os corpos de requisição reais que seu agente OpenClaw envia pela RunAPI. Cada modalidade usa um endpoint diferente mas a mesma chave de API e autenticação. Troque de modelo alterando o campo model.
{
"model": "gpt-5.5",
"messages": [
{
"role": "user",
"content": "Summarize this pull request"
}
],
"stream": true
}{
"model": "flux-kontext-pro",
"prompt": "Product photo of wireless headphones on marble surface"
}{
"model": "kling-3.0",
"prompt": "Drone flyover of a coastal city at golden hour",
"duration": "5"
}{
"model": "suno-v4.5",
"prompt": "Upbeat jazz piano loop, 120 BPM, no vocals",
"duration": 30
}SETUP GUIDE
Como configurar a RunAPI no OpenClaw
1
Defina a chave de API
Crie uma conta gratuita na RunAPI, gere uma chave de API no painel e exporte-a como RUNAPI_API_KEY no seu perfil de shell. O OpenClaw lê a chave do ambiente na inicialização.
2
Adicione a RunAPI como provedor
Abra a configuração do OpenClaw e adicione um provedor personalizado com baseUrl https://runapi.ai/v1, api definido como openai-completions e o ID de modelo que você quer usar, como gpt-5.5. Defina models.mode como merge para manter os provedores existentes.
3
Verifique e inicie
Execute openclaw models status para confirmar que o modelo RunAPI aparece. Troque para ele com openclaw models set runapi/gpt-5.5 e inicie uma sessão OpenClaw. As ferramentas de imagem, vídeo e música funcionam pela mesma chave de API.
DEVELOPER DIFFERENCES
O que muda quando você migra para RunAPI no OpenClaw
Sem habilidades extras necessárias
ConfiguraçãoOutros provedores exigem habilidades personalizadas do GitHub, scripts bash ou plugins de ComfyUI para geração de mídia no OpenClaw. A RunAPI funciona pela interface padrão de provedor compatível com OpenAI sem instalação adicional.
Acesso direto ao Suno
MúsicaTutoriais de geração de música no OpenClaw mostram arquiteturas multi-hop: Telegram para OpenClaw para um serviço intermediário para Suno. A RunAPI fornece Suno v4 até v5.5 diretamente, removendo a camada intermediária e seus pontos de falha.
Controle de custos por modelo
PreçosO catálogo da RunAPI permite escolher o ponto de custo-desempenho para cada tarefa. Use gpt-5.4-nano para classificação simples, gpt-5.5 para raciocínio complexo, flux-kontext-pro para imagens de produção e suno-v4 para música em rascunho.
Ciclo de vida async consistente
Fluxo de trabalhoTarefas de imagem, vídeo e música compartilham o mesmo ciclo de vida criar-sondar-webhook. Seu agente OpenClaw cria uma tarefa, sonda até a conclusão e recebe a URL de saída. Mudar de Kling para Veo altera o campo do modelo, não o código de integração.
PRICING COMPARISON
O custo da API varia por provedor e modalidade
Os custos de geração de imagens variam de $1 por 28 imagens no Replicate a 1.670 imagens por dólar no Runware. Os custos de LLM dependem do modelo e da contagem de tokens. A RunAPI usa preços de pagamento por uso em todas as modalidades, sem assinaturas, sem créditos que expiram e sem gasto mínimo. Consulte a página de preços ao vivo para as tarifas atuais por chamada.
Metodologia
Os dados de preços vêm da documentação dos provedores, páginas públicas de preços de API e relatórios da comunidade de desenvolvedores até junho de 2026. Os custos mudam com frequência. Sempre verifique os preços atuais na página de preços do provedor antes da implantação em produção.
FAQ
Melhor API para OpenClaw — perguntas frequentes
O OpenClaw pode usar a RunAPI para geração de imagens, vídeo e música?
Sim. A RunAPI fornece mais de 113 modelos em modalidades LLM, imagem, vídeo e música através de uma única chave de API. Configure a RunAPI como provedor personalizado compatível com OpenAI no OpenClaw e os quatro tipos de ferramentas funcionam sem habilidades ou plugins extras.
A RunAPI é mais barata do que usar o OpenAI diretamente para o OpenClaw?
A RunAPI oferece os mesmos modelos da OpenAI mais mais de 90 alternativas a preços competitivos. Apenas a troca de modelo pode reduzir os custos significativamente. Use o gpt-5.4-mini para tarefas rotineiras e reserve os modelos premium para trabalhos complexos.
Preciso instalar uma habilidade personalizada para geração de imagens no OpenClaw?
Não com a RunAPI. Outros provedores exigem habilidades do GitHub ou plugins de ComfyUI. A RunAPI funciona através do endpoint padrão compatível com OpenAI, então a ferramenta image_generate integrada do OpenClaw se conecta sem configuração adicional.
Como a RunAPI lida com a geração de música Suno para o OpenClaw?
A RunAPI fornece acesso direto à API do Suno v4 até v5.5. Seu agente OpenClaw chama a ferramenta music_generate, que envia uma solicitação ao endpoint Suno da RunAPI. Nenhuma ponte de terceiros ou conta Suno separada é necessária.
Posso manter meus provedores OpenClaw existentes e adicionar a RunAPI?
Sim. Defina models.mode como merge na sua configuração do OpenClaw. A RunAPI se torna um provedor ao lado dos seus existentes. Você pode definir a RunAPI como modelo principal ou mantê-la como fallback para modalidades específicas.
O que acontece se eu ficar sem créditos da RunAPI durante uma sessão do OpenClaw?
A RunAPI retorna um código de status 402. Seu agente OpenClaw recebe um erro de créditos insuficientes e para de gerar. Adicione créditos pelo painel da RunAPI e o agente retoma imediatamente. Nenhuma assinatura é necessária.
GET STARTED
Uma chave de API. Quatro modalidades. Mais de 113 modelos.
Configure a RunAPI no OpenClaw uma vez e seu agente de programação ganha acesso a chat LLM, geração de imagens, geração de vídeo e criação musical através de uma única chave de API e conta de faturamento.