TypingMind

Adicione o OneProvider ao TypingMind como custom model. O TypingMind precisa do endereço completo do endpoint, não de uma base URL.

O TypingMind não tem um campo de base URL: o formulário de custom model recebe o endereço completo do endpoint e envia as requisições exatamente para lá, sem acrescentar nada. O campo integrado para a chave de API do Claude (Anthropic) fala diretamente com a Anthropic, então uma chave do OneProvider só funciona no TypingMind como custom model.

1. Adicione um custom model

1. No TypingMind, abra Models na barra lateral esquerda, clique em Add custom model e mantenha Create Manually.
2. Name: qualquer nome, por exemplo OneProvider claude-opus-5-5.
3. Model ID: o id exato da página de modelos , por exemplo claude-opus-5-5. O nome de exibição “Claude Opus 5.5” não é um id.
4. Context Length: a janela de contexto do modelo, na mesma página.

2. API Type, Endpoint URL e chave

Na aba Authentication, escolha um dos dois tipos de API e preencha os campos exatamente como abaixo. A mesma chave do OneProvider serve para os dois.

Claude Messages API (modelos Claude)

API Type: Claude Messages API
Endpoint URL: https://api.oneprovider.dev/v1/messages
Authentication Type: API Key via HTTP Header
Header Key: x-api-key
Header Value: sk-your-key-here
Model ID: claude-opus-5-5

OpenAI Chat Completions API (modelos GPT e Claude)

API Type: OpenAI Chat Completions API
Endpoint URL: https://api.oneprovider.dev/v1/chat/completions
Authentication Type: API Key via HTTP Header
Header Key: Authorization
Header Value: Bearer sk-your-key-here
Model ID: gpt-6.1-terra

Header Value é a palavra Bearer, um espaço e depois a sua chave completa. Ids do Claude como claude-sonnet-5-5 também funcionam nessa rota.

3. Temperature e opções da requisição

• Deixe temperature no valor padrão. Os modelos Claude 5.x respondem 400 a uma temperature diferente; se você a alterou nas configurações do modelo ou do chat do TypingMind, restaure o padrão.
• Route requests via TypingMind Cloud não é necessário: nossa API aceita requisições direto do navegador (CORS).

4. Test & Save

Clique em Test & Save e depois escolha o novo modelo em um chat.

Cada modelo é um custom model separado: repita os passos para cada id que quiser, com a mesma Endpoint URL e a mesma chave.

Qual modelo escolher

claude-opus-5-5 é indicado para chats longos e exigentes, claude-sonnet-5-5 é a opção equilibrada padrão e claude-haiku-5-5 é a opção rápida e barata; modelos GPT como gpt-6.1-terra usam o tipo OpenAI Chat Completions API. Digite o id exatamente como na página de modelos ; as tarifas estão na página de preços .

Erros comuns e soluções

404 Not Found

A Endpoint URL é uma base URL (https://api.oneprovider.dev/v1 ou https://api.oneprovider.dev). Use https://api.oneprovider.dev/v1/messages para o tipo Claude Messages API ou https://api.oneprovider.dev/v1/chat/completions para o tipo OpenAI Chat Completions API.

Modelo não encontrado ou indisponível

O Model ID precisa ser o id exato, por exemplo claude-opus-5-5, e não o nome de exibição do modelo. Copie-o da página de modelos .

400 por causa da temperature

Os modelos Claude 5.x aceitam apenas a temperature padrão. Restaure a temperature no TypingMind para o padrão e envie a mensagem de novo.

401 authentication_error

Claude Messages API: Header Key x-api-key e a chave completa como valor. OpenAI Chat Completions API: Header Key Authorization e Bearer sk-... como valor.

A chave não funciona no campo integrado do Claude no TypingMind

Esse campo envia as requisições para a Anthropic, que não reconhece uma chave do OneProvider. Adicione o OneProvider como custom model, como mostrado acima.

Perguntas frequentes

O TypingMind precisa de uma base URL ou do endpoint completo?

Do endpoint completo. O TypingMind não acrescenta nenhuma rota, por isso o endereço precisa terminar em /v1/messages ou /v1/chat/completions.

Preciso de Route requests via TypingMind Cloud?

Não. Nossa API aceita requisições do navegador (CORS), então o TypingMind pode chamá-la diretamente.

Posso usar modelos GPT?

Sim: escolha o tipo OpenAI Chat Completions API e um id de GPT como gpt-6.1-terra.

Uma única entrada pode cobrir todos os modelos?

Não. Cada modelo é um custom model separado, com a mesma Endpoint URL e a mesma chave.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .