Skip to main content
Para conectar n8n con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza.

​
Ajustes principales

​
Requisitos previos

​
Requisitos adicionales

  • Una instancia de n8n Cloud o autohospedada
Conserva /v1 al final de la Base URL. No añadas /chat/completions ni /responses; n8n incorpora la ruta que necesita el nodo.

​
Instalación

Instala o abre n8n y continúa con la configuración manual siguiente.

​
Configuración manual

Completa esta configuración en la interfaz del nodo de n8n. No necesitas editar un archivo de configuración de n8n.

​
Pasos de configuración

1

Añade AI Agent y OpenAI Chat Model

Abre un workflow y añade un nodo AI Agent. En su conector Chat Model, añade el subnodo OpenAI Chat Model.Esta guía usa OpenAI Chat Model porque proporciona la conexión al modelo para AI Agents, cadenas y otros workflows de IA de n8n.
2

Crea una credencial OpenAI

En OpenAI Chat Model, abre Credential to connect with, selecciona Create new credential y elige OpenAI.Si tu versión de n8n ofrece OpenAI Account (ChatGPT) y API Key, elige API Key. La autenticación OpenAI Account corresponde a una cuenta oficial, no a una Base URL personalizada de BetterToken.
3

Introduce la credencial de BetterToken

Usa estos valores:Haz clic en Save. n8n prueba esta credencial contra /models bajo la Base URL configurada, por lo que la URL completa de prueba es https://www.bettertoken.ai/v1/models.
4

Selecciona un modelo

Vuelve a OpenAI Chat Model, abre Model y selecciona el ID de modelo de un proveedor compatible que aparezca en la model plaza.Si la lista no se actualiza después de guardar la credencial, vuelve a abrir el nodo o la credencial y carga de nuevo la lista de modelos.
5

Elige Chat Completions o Responses

Para la primera prueba, mantén Use Responses API desactivado y completa una conversación sencilla mediante el modo Chat Completions predeterminado.Activa Use Responses API solo cuando tu workflow lo necesite. n8n documenta herramientas integradas como Web Search, File Search y Code Interpreter para OpenAI Chat Model + AI Agent con Responses activado. Esas herramientas alojadas por OpenAI no son capacidades confirmadas automáticamente para BetterToken; pruébalas con el modelo y endpoint seleccionados.
6

Ejecuta una prueba

Proporciona al AI Agent una entrada sencilla:
Haz clic en Execute step o ejecuta el workflow. La configuración está completa cuando el nodo devuelve una respuesta del modelo.

​
Verifica la conexión

Envía un prompt de prueba breve. Si la herramienta responde sin errores de autenticación ni de ID del modelo, la conexión funciona. Reinicia por completo la herramienta después de cambiar la configuración.

​
Cambia de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.

​
Errores habituales

​
La prueba de credenciales devuelve 401

  • Comprueba que la API Key esté completa y no contenga espacios adicionales
  • Confirma que la Key use un ID de modelo del proveedor compatible
  • Comprueba el estado de la Key y el saldo en el Dashboard de BetterToken

​
La prueba de credenciales devuelve 404

  • La Base URL debe ser https://www.bettertoken.ai/v1
  • No uses https://www.bettertoken.ai/v1/models como Base URL
  • No añadas /chat/completions ni /responses

​
La lista de modelos está vacía

  • Vuelve a guardar la credencial y abre de nuevo Model
  • Confirma que la API Key pueda acceder a https://www.bettertoken.ai/v1/models
  • Copia un ID de modelo vigente desde la model plaza; no uses un ID retirado o mal escrito

​
El chat funciona, pero fallan las herramientas del Agent

Desactiva Use Responses API y todas las herramientas integradas y verifica Chat Completions sin herramientas. Activa las herramientas del Agent una por una para determinar si el problema está en la capacidad del modelo, los argumentos de la herramienta o la configuración del workflow.

​
La solicitud agota el tiempo de espera

Aumenta Timeout en OpenAI Chat Model > Options y mantén un valor limitado de Max Retries. No reintentes repetidamente errores 400, 401 ni errores de configuración.

​
Configuración avanzada

​
Proveedores compatibles

Los estados se aplican al método de configuración de BetterToken descrito en esta página.
  • Configuración manual: introduce la API Key, la Base URL y el Model.
  • No compatible: todavía no hay un método de conexión directa verificado.

​
Guías relacionadas

​
Detalles técnicos

Esta configuración usa https://www.bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.

​
Alcance

Esta guía confirma únicamente LLM Chat mediante el protocolo compatible con OpenAI. No configures un modelo de chat GPT como modelo de embedding, rerank, voz o imagen.