TL;DR
TypingMind é uma interface flexível de chat de IA que permite conectar GPT, Claude, DeepSeek e outros modelos compatíveis usando suas próprias chaves de API. Ao integrar a CometAPI por meio de uma conexão compatível com OpenAI, você pode acessar vários modelos de IA sem configurar contas separadas de provedores. Este guia explica como adicionar um modelo personalizado usando sua chave de API da CometAPI e o endpoint de Chat Completions, enviar sua primeira mensagem e solucionar erros comuns de configuração. Você precisará de uma chave de API da CometAPI, crédito disponível na conta e acesso às configurações de modelo personalizado do TypingMind. Comece com um prompt de texto básico e, conforme necessário, ative recursos avançados. Um exemplo opcional em Bash e cURL também está incluído para testar a conexão com a API.
Key Takeaways
- Uma chave de API, vários modelos: acesse provedores compatíveis por meio de uma única conta CometAPI.
- Integração compatível com OpenAI: configure um endpoint padrão de Chat Completions sem um SDK personalizado.
- Seleção flexível de modelos: registre vários modelos com suporte da CometAPI no TypingMind.
- Faturamento separado: a inferência do modelo é faturada pela CometAPI; a licença do TypingMind é separada.
What is TypingMind
TypingMind é uma interface de chat de IA que se conecta a modelos por meio das chaves de API que você fornece. Ela oferece um único lugar para selecionar modelos e gerenciar conversas. O TypingMind fornece a interface; o serviço de API conectado lida com as requisições ao modelo e a cobrança de uso.
A CometAPI fornece ao TypingMind uma conexão de API compartilhada para modelos compatíveis de vários provedores, incluindo GPT, Claude, Gemini e DeepSeek. Você pode gerenciar o acesso à API e o faturamento com uma única conta CometAPI e, em seguida, criar entradas de modelos personalizados separados no TypingMind para os modelos que deseja usar. Isso facilita experimentar diferentes modelos para escrita, programação ou perguntas do dia a dia sem precisar configurar uma conta de API separada com cada provedor.
What Do You Need Before Connecting CometAPI to TypingMind?
Crie uma chave na seção API Keys da conta CometAPI, seguindo as instruções de criação de chaves. Use uma chave dedicada para essa conexão, assim você pode revogá-la sem afetar integrações não relacionadas. Mantenha a chave fora de capturas de tela, documentos compartilhados e repositórios públicos.
A CometAPI oferece suporte a várias famílias de modelos, incluindo GPT, Claude, Gemini e DeepSeek; ela não se limita à GPT-6 Luna. Este tutorial usa a GPT-6 Luna (ID do modelo: gpt-6-luna) apenas como exemplo para a tabela de configuração e o teste no terminal. Você pode escolher outro modelo do catálogo de modelos da CometAPI, desde que sua conta tenha acesso a ele e sua rota ofereça suporte ao OpenAI Chat Completions.
Ao usar outro modelo, substitua gpt-6-luna pelo ID exato desse modelo tanto no TypingMind quanto na requisição cURL. Atualize também o nome de exibição, o comprimento de contexto, os preços e as configurações de recursos para corresponder ao modelo selecionado. As configurações do modelo de exemplo não devem ser consideradas válidas para todos os modelos.
Use a configuração abaixo. O TypingMind precisa da URL completa do endpoint; uma URL base de SDK terminando em /v1 é um campo diferente e não deve ser usada aqui.
| Campo do TypingMind | Valor |
|---|---|
| Nome | GPT-6 Luna via CometAPI |
| ID do modelo | gpt-6-luna |
| API type | OpenAI Chat Completions API |
| Endpoint URL | https://api.cometapi.com/v1/chat/completions |
| Autenticação | Chave de API via cabeçalho HTTP |
| Chave do cabeçalho | Authorization |
| Valor do cabeçalho | Bearer YOUR_COMETAPI_API_KEY |
How Do You Add CometAPI to TypingMind?
Create a custom model
Abra o TypingMind, selecione Models e escolha Add custom model. Mantenha Create Manually selecionado. O fluxo de configuração manual documenta esses controles.
Enter the model details
Copie o nome e o ID do modelo da tabela de configuração. Se Context Length for obrigatório, use o limite documentado do modelo selecionado; a janela de contexto documentada da GPT-6 Luna é de 1.050.000 tokens. Um limite de contexto é uma configuração de capacidade, não uma recomendação para enviar essa quantidade de tokens.
Set the endpoint and authentication
Em Authentication, insira o tipo de API, o endpoint, a chave do cabeçalho e o valor do cabeçalho da tabela. Substitua YOUR_COMETAPI_API_KEY pela sua chave real. Inclua um espaço após Bearer e não use aspas.
Ambas as capturas de tela são do guia oficial do TypingMind. O formulário de autenticação vazio ilustra a posição dos campos; insira seu próprio endpoint da CometAPI, ID do modelo e chave.
Test and save the connection
Comece com chat de texto e deixe as substituições opcionais de requisição desativadas. Clique em Test & Save, selecione o modelo salvo e envie: “Explique APIs REST versus WebSockets em três frases.” Uma resposta visível do assistente confirma a conexão básica. Envie uma mensagem de acompanhamento para verificar se a conversa continua.
Enable optional capabilities
Comece com chat de texto. Ative streaming, prompts de sistema, entrada de imagem, ferramentas ou controles de raciocínio apenas quando houver suporte. Teste os recursos avançados separadamente.
As configurações Capabilities do TypingMind fornecem verificações automáticas e controles manuais. Trate a detecção como um ponto de partida: verifique cada recurso com o modelo e a rota selecionados. Mantenha a configuração básica funcional para poder remover a substituição mais recente se um teste de recurso falhar.
How Do You Check the CometAPI Request Outside TypingMind?
Use este teste opcional quando o Test & Save falhar. Ele envia uma requisição mínima usando a mesma chave e ID do modelo, seguindo o formato de requisição de Chat Completions documentado pela CometAPI. Não é necessário alterar a configuração do TypingMind.
Set the key for the current Bash session
Execute o seguinte no Bash, incluindo Git Bash ou WSL no Windows. Cole a chave no prompt oculto. Esses comandos são sintaxe Bash e não devem ser colados no PowerShell sem alterações.
read -r -s -p "CometAPI API key: " COMETAPI_API_KEYprintf '\n'export COMETAPI_API_KEY
Send a minimal chat request
curl --include --silent --show-error \ https://api.cometapi.com/v1/chat/completions \ -H "Authorization: Bearer $COMETAPI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6-luna", "messages": [ {"role": "user", "content": "Explain API gateways in one sentence."} ] }'
Inspecione choices[0].message.content para o texto do assistente. Se o cURL retornar um erro HTTP, leia o corpo da resposta antes de alterar as configurações. Se ele tiver êxito enquanto o TypingMind falha, compare o endpoint, a chave, o ID do modelo e as substituições opcionais; em seguida, verifique o painel Network do navegador. Uma requisição bem-sucedida no terminal confirma esse caminho de requisição; ela não verifica o acesso do navegador nem todos os recursos do modelo.
Remove the temporary environment variable
unset COMETAPI_API_KEY
How to Troubleshoot TypingMind Connection Errors
Use o corpo da resposta e o painel Network do navegador para identificar a requisição com falha. As verificações abaixo são pontos de partida, não um diagnóstico com base apenas no código de status. Mantenha as credenciais fora de capturas de tela e mensagens de suporte.
| Sintoma | Primeira verificação | Próxima ação |
|---|---|---|
| 401 Unauthorized | Chave e cabeçalho Authorization | Verifique chave expirada ou revogada, espaços extras ou ausência do prefixo Bearer. |
| 403 Forbidden | Corpo da resposta e acesso ao modelo | Confirme permissões da conta e acesso à rota selecionada. |
| 404 Not Found | Endpoint e ID exato do modelo | Use a URL completa /v1/chat/completions e confirme o ID no catálogo. |
| 400 Bad Request | Corpo da requisição e overrides | Remova parâmetros opcionais e tente novamente com uma requisição de texto simples. |
| 429 Too Many Requests | Detalhes de cota ou rate limit | Verifique limites da conta e crédito. Pause novas tentativas sob rate limit; resolva a cota antes de retentar. |
| Browser network error | Painel de rede e console | Verifique conectividade e qualquer erro de origem cruzada reportado; compare com o teste no terminal. |
| Streaming fails | Configuração de streaming e suporte da rota | Tente novamente com o streaming desativado para isolar a falha. |
Uma API pode funcionar em Python ou cURL, mas falhar em um navegador devido a restrições de origem cruzada. Não exponha uma chave de API irrestrita por meio de um proxy público inseguro apenas para contornar o CORS.
FAQ
Can I keep an existing TypingMind connection while adding CometAPI?
Sim: crie uma entrada de modelo personalizado separada com um nome de exibição distinto, em vez de editar a entrada do provedor existente. Mantenha o endpoint original e as configurações do modelo disponíveis enquanto você valida a conexão com a CometAPI. Teste primeiro em um novo chat para que o comprimento de uma conversa antiga ou anexos não ocultem um erro básico de configuração.
How should I rotate a CometAPI key used in TypingMind?
Crie uma chave de substituição, atualize cada entrada de modelo personalizado que usa a chave antiga e teste uma nova requisição a partir de cada entrada. Revogue a chave antiga depois que a substituição funcionar. Se a chave antiga tiver sido exposta, revogue-a imediatamente e restaure as conexões afetadas com uma nova chave.
Why can TypingMind’s cost estimate differ from the CometAPI bill?
O TypingMind estima o uso a partir das tarifas inseridas em suas configurações de Pricing. Tarifas desatualizadas ou diferenças em cache, níveis de contexto ou contabilização de reasoning tokens podem produzir divergências. Compare as tarifas atuais do modelo e o uso de uma requisição específica com as informações de faturamento da CometAPI; não trate a estimativa no cliente como a cobrança final.
Conclusion
Para conectar a CometAPI ao TypingMind, crie um modelo personalizado manual, insira o endpoint completo de Chat Completions, adicione o cabeçalho Authorization e teste uma mensagem de texto simples. Mantenha uma configuração funcional antes de adicionar recursos opcionais. Quando a configuração falhar, uma requisição mínima via cURL ajuda a distinguir erros de conta ou API de problemas do navegador e de configurações de frontend.