Configure OpenCat, ChatBox e LobeChat com WaveSpeed LLM: mais de 290 modelos em um único app
Configuração passo a passo do OpenCat, ChatBox e LobeChat com o WaveSpeed LLM. Exatamente o que preencher nos campos de Endpoint, Chave de API e Protocolo de Chat — sem adivinhações.
Os Três Campos que Todo App de Chat Solicita
Todo app de chat LLM moderno para desktop/mobile — OpenCat, ChatBox, LobeChat, ChatGPT Next Web, Cherry Studio e dezenas de outros — pede que você preencha os mesmos três campos ao adicionar um provedor personalizado:
- Endpoint (às vezes chamado de “API Host”, “Base URL” ou “Server URL”)
- API Key (às vezes “Secret Key”, “SK” ou “Token”)
- Protocolo de Chat (às vezes “API Type” ou “Compatible Mode”)
Para a maioria das pessoas, esses três campos são onde a configuração trava. Este guia mostra exatamente o que colar, para três dos apps de chat mais populares — OpenCat, ChatBox e LobeChat — usando o WaveSpeed LLM como backend.
As Respostas Universais
Independentemente do app de chat que você está configurando, para o WaveSpeed LLM as respostas são sempre:
| Campo | Valor |
|---|---|
| Endpoint / Base URL | https://llm.wavespeed.ai/v1 |
| API Key | Sua chave de API WaveSpeed (do painel) |
| Protocolo de Chat | OpenAI (Chat Completions) |
| Model ID | vendor/model — ex.: anthropic/claude-opus-4.6 |
Com esses quatro valores você pode conectar qualquer cliente compatível com OpenAI. A seguir, percorremos três apps específicos.
Pré-requisito: Obtenha Sua Chave de API WaveSpeed
- Acesse wavespeed.ai e faça login.
- Abra Dashboard → API Keys.
- Crie uma nova chave, copie-a imediatamente e guarde como segredo.
Mantenha essa aba aberta — você vai colar a chave em cada app abaixo.
OpenCat
OpenCat é um popular cliente de chat nativo para macOS e iOS.
- Abra o OpenCat → Settings → API Providers → Add Provider (ou edite um provedor OpenAI existente).
- Preencha:
- Name: WaveSpeed LLM (qualquer rótulo que preferir)
- API Host:
https://llm.wavespeed.ai/v1 - API Key:
SUA_CHAVE_WAVESPEED_API - Protocol / Provider Type: OpenAI
- Salve. O OpenCat listará os modelos disponíveis — escolha
anthropic/claude-opus-4.6ou qualquer outro modelo do catálogo WaveSpeed. - Se o OpenCat não listar os modelos automaticamente, adicione um manualmente com o ID
anthropic/claude-opus-4.6.
Dica: O OpenCat permite criar múltiplos assistentes com modelos diferentes. Aponte cada um para um model ID diferente do WaveSpeed para comparar Claude, GPT e Gemini lado a lado.
ChatBox
ChatBox é um app de chat multiplataforma (Windows, macOS, Linux, mobile).
- Abra o ChatBox → Settings → Model.
- Configure:
- Model Provider: OpenAI API (ou “Custom OpenAI”)
- API Key:
SUA_CHAVE_WAVESPEED_API - API Host:
https://llm.wavespeed.ai/v1 - API Path:
/chat/completions(padrão, deixe como está) - Model:
anthropic/claude-opus-4.6(digite manualmente se não estiver na lista)
- Salve e inicie um novo chat.
O ChatBox armazena em cache sua lista de modelos por provedor. Se os modelos não aparecerem, digite o ID do modelo manualmente — o ChatBox o utilizará.
LobeChat
LobeChat é uma interface de chat open-source completa, auto-hospedável ou via lobehub.com.
- Abra o LobeChat → Settings → Language Model → OpenAI.
- Ative Enable.
- Preencha:
- API Key:
SUA_CHAVE_WAVESPEED_API - API Proxy Address (ou Base URL):
https://llm.wavespeed.ai/v1
- API Key:
- Em Model List, adicione um modelo personalizado:
- Model ID:
anthropic/claude-opus-4.6 - Display name: qualquer nome que desejar
- Model ID:
- Salve e selecione o novo modelo em uma conversa.
O provedor OpenAI do LobeChat é o correto a escolher mesmo quando você está chamando Claude ou Gemini pelo WaveSpeed — o cliente fala OpenAI Chat Completions e o WaveSpeed traduz para os modelos upstream de forma transparente.
Por Que “OpenAI” é Sempre a Escolha Certa de Protocolo
Um ponto de confusão comum: se estou chamando o Claude pelo WaveSpeed, não deveria escolher “Anthropic” como protocolo?
Não. Escolha OpenAI.
O WaveSpeed LLM expõe todos os modelos — Claude, GPT, Gemini, Llama, Qwen, DeepSeek — por meio do protocolo OpenAI Chat Completions. O prefixo anthropic/ no model ID apenas informa ao WaveSpeed qual modelo upstream utilizar. Seu app de chat só precisa falar OpenAI.
Este é o ponto central de um gateway unificado compatível com OpenAI: sua ferramenta não precisa conhecer a diferença.
Model IDs Populares para Experimentar
| Model ID | Observações |
|---|---|
anthropic/claude-opus-4.6 | Claude com contexto de 1M |
anthropic/claude-sonnet-4.6 | Claude mais rápido e econômico |
openai/gpt-5.2-pro | Melhor raciocínio OpenAI |
openai/gpt-5.2-chat | GPT equilibrado |
google/gemini-3-flash-preview | Multimodal rápido |
deepseek/deepseek-v4 | Programador forte mais barato |
meta-llama/llama-4-70b | Pesos abertos, estável |
Navegue pelo catálogo completo em wavespeed.ai/llm.
Solução de Problemas
“Invalid API Key” / 401 Unauthorized Você colou a chave errada. Copie a chave do painel WaveSpeed exatamente — sem espaços no início ou no fim.
“Model not found” / 404
O model ID deve usar o formato completo vendor/model. Se o cliente completar automaticamente para uma forma reduzida como claude-opus-4.6, edite manualmente.
App tenta conectar a api.openai.com
Você esqueceu de alterar a Base URL / API Host. Reabra as configurações e confirme que está como https://llm.wavespeed.ai/v1.
Erros de SSL / certificado
Atualize seu app de chat para a versão mais recente. Todas as versões modernas suportam conexões TLS padrão com llm.wavespeed.ai.
Uma Chave, Muitos Apps
Adicione a mesma chave de API WaveSpeed a todos os clientes de chat que você usa. Uma conta, uma cobrança, mais de 290 modelos em todo lugar.
Obtenha sua chave de API WaveSpeed e conecte seu app de chat favorito em minutos.
