n8n con BetterToken: API Key, Base URL y modelos
Conecta n8n con BetterToken mediante una Base URL, una API Key y un modelo disponible; después, verifica la conexión y corrige los errores habituales.
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
| Campo | Valor |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Modelo | Un ID de modelo vigente de la model plaza |
Requisitos previos
- La versión actual de la herramienta está instalada
- Una BetterToken API Key: regístrate y obtén una
- Un ID de modelo de la model plaza
¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.
Requisitos adicionales
- Una instancia de n8n Cloud o autohospedada
| Ajuste | Valor |
|---|---|
| Credential type | OpenAI |
| Base URL | https://bettertoken.ai/v1 |
| API Key | Tu BetterToken API Key |
| Organization ID | Déjalo en blanco |
| Custom Header | Desactivado |
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.
| Campo | Valor |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Modelo | Un ID de modelo vigente de la model plaza |
Pasos de configuración
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.
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.
Introduce la credencial de BetterToken
Usa estos valores:
| Campo de n8n | Valor |
|---|---|
| API Key | Tu BetterToken API Key |
| Organization ID (optional) | Déjalo en blanco |
| Base URL | https://bettertoken.ai/v1 |
| Add Custom Header | Desactivado |
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://bettertoken.ai/v1/models.
Selecciona un modelo
Vuelve a OpenAI Chat Model, abre Model y selecciona el ID de modelo disponible 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.
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.
Ejecuta una prueba
Proporciona al AI Agent una entrada sencilla:
Reply with exactly: Connection successfulHaz 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
- Copia el Model ID exacto de la model plaza.
- 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://bettertoken.ai/v1 - No uses
https://bettertoken.ai/v1/modelscomo Base URL - No añadas
/chat/completionsni/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://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
Guías relacionadas
Detalles técnicos
Protocolo, endpoint y campos internos del proveedor
Esta configuración usa https://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.
