> ## Documentation Index > Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt > Use this file to discover all available pages before exploring further. # Configuração da BetterToken no n8n: API Key, Base URL e modelos personalizados > Conecte o n8n à BetterToken com uma Base URL, API Key e modelo de provedor compatível; depois verifique a conexão e corrija erros comuns. Para conectar o n8n à BetterToken, prepare uma API Key, informe a Base URL abaixo e escolha um ID de modelo atual na model plaza. ## Configurações principais | Campo | Valor | | -------- | ----------------------------------------------------------------------------------- | | API Key | BetterToken API Key | | Base URL | `https://www.bettertoken.ai/v1` | | Modelo | Um ID de modelo atual da model plaza | ## Pré-requisitos * A versão atual da ferramenta está instalada * Uma BetterToken API Key: cadastre-se e crie uma * Um ID de modelo da model plaza ### Requisitos adicionais * Uma instância do n8n Cloud ou auto-hospedada | Configuração | Valor | | ------------------ | ------------------------------- | | Tipo de credencial | `OpenAI` | | Base URL | `https://www.bettertoken.ai/v1` | | API Key | sua BetterToken API Key | | Organization ID | deixe em branco | | Custom Header | desativado | Mantenha `/v1` no final da Base URL. Não adicione `/chat/completions` ou `/responses`; o n8n acrescenta a rota exigida pelo nó. ## Instalação Instale ou abra o n8n e continue com a configuração manual abaixo. ## Configuração manual Conclua a configuração na interface do nó do n8n. Não é necessário editar um arquivo de configuração do n8n. | Campo | Valor | | -------- | ----------------------------------------------------------------------------------- | | API Key | BetterToken API Key | | Base URL | `https://www.bettertoken.ai/v1` | | Modelo | Um ID de modelo atual da model plaza | ### Configuração Abra um fluxo de trabalho e adicione um nó **AI Agent**. No conector **Chat Model**, adicione o subnó **OpenAI Chat Model**. Este guia usa **OpenAI Chat Model** porque ele fornece a conexão do modelo para AI Agents, cadeias e outros fluxos de IA do n8n. Em **OpenAI Chat Model**, abra **Credential to connect with**, selecione **Create new credential** e escolha **OpenAI**. Se sua versão do n8n oferecer **OpenAI Account (ChatGPT)** e **API Key**, escolha **API Key**. A autenticação OpenAI Account é para uma conta oficial, não para uma Base URL personalizada da BetterToken. Use estes valores: | Campo do n8n | Valor | | -------------------------- | ------------------------------- | | API Key | sua BetterToken API Key | | Organization ID (opcional) | deixe em branco | | Base URL | `https://www.bettertoken.ai/v1` | | Add Custom Header | desativado | Clique em **Save**. O n8n testa essa credencial em `/models` na Base URL configurada; portanto, a URL de teste completa é `https://www.bettertoken.ai/v1/models`. Volte a **OpenAI Chat Model**, abra **Model** e selecione o ID de modelo de um provedor compatível mostrado na model plaza. Se a lista não atualizar após salvar a credencial, reabra o nó ou a credencial e carregue novamente a lista de modelos. No primeiro teste, mantenha **Use Responses API** desativado e faça uma conversa simples pelo modo padrão Chat Completions. Ative **Use Responses API** somente quando o fluxo precisar disso. O n8n documenta ferramentas integradas como Web Search, File Search e Code Interpreter para **OpenAI Chat Model + AI Agent** com Responses ativado. Essas ferramentas hospedadas pela OpenAI não são automaticamente recursos confirmados para a BetterToken; teste-as com o modelo e endpoint selecionados. Dê uma entrada simples ao AI Agent: ```text theme={null} Reply with exactly: Connection successful ``` Clique em **Execute step** ou execute o fluxo. A configuração estará concluída quando o nó retornar uma resposta do modelo. ## Verifique a conexão Envie um prompt de teste curto. Se a ferramenta retornar uma resposta sem erro de autenticação ou de ID de modelo, a conexão funciona. Reinicie completamente a ferramenta depois de alterar a configuração. ## Alterne entre modelos Abra o seletor de modelos ou altere o campo `Model` na configuração. Use o ID de modelo exato da model plaza e reinicie a sessão atual. ## Erros comuns ### O teste de credencial retorna 401 * Verifique se a API Key está completa e sem espaços extras * Confirme que a chave usa um ID de modelo de um **provedor compatível** * Verifique o status e o saldo da chave no Dashboard da BetterToken ### O teste de credencial retorna 404 * A Base URL deve ser `https://www.bettertoken.ai/v1` * Não use `https://www.bettertoken.ai/v1/models` como Base URL * Não acrescente `/chat/completions` ou `/responses` ### A lista de modelos está vazia * Salve a credencial novamente e reabra **Model** * Confirme que a API Key pode acessar `https://www.bettertoken.ai/v1/models` * Copie um ID de modelo atual da model plaza; não use um ID descontinuado ou escrito incorretamente ### O chat simples funciona, mas chamadas de ferramenta do Agent falham Desative **Use Responses API** e todas as ferramentas integradas, depois verifique Chat Completions simples. Ative as ferramentas do Agent uma de cada vez para identificar se o problema é a capacidade do modelo, os argumentos da ferramenta ou a configuração do fluxo. ### A solicitação expira Aumente **Timeout** em **OpenAI Chat Model > Options** e mantenha **Max Retries** limitado. Não repita tentativas para erros `400`, `401` ou de configuração. ## Advanced setup ## Provedores compatíveis | Provedor | Status | | -------- | ------------------- | | Claude | Sem suporte | | GPT | Configuração manual | | Kimi | Configuração manual | | GLM | Configuração manual | Os status se aplicam ao método de configuração do BetterToken descrito nesta página. * **Configuração manual**: informe a API Key, a Base URL e o Model. * **Sem suporte**: ainda não há um método verificado de conexão direta. ### Guias relacionados * [n8n OpenAI credentials](https://docs.n8n.io/integrations/builtin/credentials/openai/) * [n8n OpenAI Chat Model](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/) * [API compatível com OpenAI vs. API compatível com Anthropic](/pt-br/faq/concepts/openai-compatible-vs-anthropic-compatible) * [Como escolher um modelo](/pt-br/faq/model-calling/model-selection-guide) ## Detalhes técnicos Esta configuração usa `https://www.bettertoken.ai/v1`. A ferramenta acrescenta o caminho de endpoint compatível com OpenAI. Não adicione `/chat/completions` ou `/responses`, exceto quando um campo específico exigir isso. ### Escopo Este guia confirma somente LLM Chat pelo protocolo compatível com OpenAI. Não configure um modelo de chat GPT como modelo de embedding, rerank, fala ou imagem.