Dify con BetterToken: API Key, Base URL y modelos

Para conectar Dify 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

Regístrate y obtén una BetterToken API Key→

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

• Dify Cloud o una instancia autohospedada de Dify con plugins activados
• Permiso para instalar plugins de modelos y gestionar los modelos del workspace

Esta guía configura únicamente LLM Chat. No añadas un modelo de chat GPT como Text Embedding, Rerank, Speech-to-Text ni Text-to-Speech.

Instalación

Instala el plugin de modelos compatible con OpenAI

Abre Model Providers

En el workspace de Dify, ve a Integrations > Model Providers.

Instala el plugin oficial

Haz clic en Install model providers, busca OpenAI-API-compatible e instálalo.

Dify gestiona los proveedores de modelos como plugins del workspace. Después de instalarlo, las aplicaciones con los permisos necesarios pueden seleccionar modelos de este proveedor.

Añade un modelo personalizado

En la tarjeta OpenAI-API-compatible, haz clic en Add Model. Si la tarjeta muestra primero Setup o Configure, ábrela y elige la opción para añadir un modelo.

Configuración manual

Completa esta configuración en la interfaz de proveedores de modelos de Dify. No necesitas editar un archivo de configuración.

Campo	Valor
API Key	BetterToken API Key
Base URL	https://bettertoken.ai/v1
Modelo	Un ID de modelo vigente de la model plaza

Introduce la configuración del modelo

Usa estos valores para el primer modelo:

Campo de Dify	Valor recomendado
Model Type	LLM
Model Name	Un ID de modelo disponible de la model plaza
Model display name	Puedes usar el mismo valor que en Model Name
API Key	Tu BetterToken API Key
API Base URL	https://bettertoken.ai/v1
model name for API endpoint	El mismo ID de modelo que en Model Name
Completion mode	Chat
Model context size	Debe coincidir con el modelo seleccionado; si tienes dudas, conserva el valor predeterminado del plugin
Upper bound for max tokens	No superes el límite del modelo; conserva el valor predeterminado para la primera prueba
Compatibility mode	OpenAI compatible / estricto
Token parameter name	Auto
Function Call Type	Not Support para la primera prueba

Introduce únicamente https://bettertoken.ai/v1 como API Base URL. No añadas /chat/completions; el plugin de Dify llama al endpoint necesario.

Usa valores conservadores para las demás capacidades opcionales:

• Thinking Mode Support: actívalo solo después de confirmar que el modelo lo admite
• Stream function calling: selecciona Not Support para la primera prueba
• Vision Support: actívalo solo cuando el modelo y el endpoint acepten imágenes de entrada
• Structured Output: mantenlo desactivado hasta que funcione el chat básico

Mantén Include Usage in Stream (stream_include_usage) en su valor predeterminado, Enabled. Añade stream_options: {include_usage: true} para solicitar el recuento de tokens en el último fragmento del flujo; desactívalo solo si el endpoint rechaza ese campo. Stream mode auth (stream_mode_auth) usa Not Use de forma predeterminada; al elegir Use, la validación de credenciales usa una solicitud en streaming sin cambiar los ajustes de generación normales. Consulta los campos oficiales del proveedor.

Haz clic en Save. Dify valida la API Key, la Base URL y el ID del modelo.

Usa el modelo en una aplicación

Crea o abre una aplicación de Dify

Abre un Chatbot, Agent, Chatflow o Workflow.

Selecciona el modelo

En el selector de modelos de la aplicación o en un nodo LLM, elige el modelo que añadiste en OpenAI-API-compatible.

Prueba primero el chat básico

Ejecuta la primera solicitud con una entrada de texto breve, sin herramientas ni imágenes:

Reply with exactly: Connection successful

Activa después las capacidades de Agent

Cuando funcione el chat básico, edita la configuración del modelo si necesitas llamadas a herramientas. Establece Function Call Type en el modo que admita el modelo. Las llamadas a herramientas compatibles con OpenAI suelen usar Tool Call, pero debes verificar que el modelo y el endpoint seleccionados lo admitan.

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.

Dify guarda una configuración personalizada para cada ID de modelo. Para añadir otro modelo disponible, vuelve a hacer clic en Add Model bajo el mismo proveedor. Usa el ID nuevo tanto en Model Name como en model name for API endpoint. Puedes reutilizar la Base URL y la API Key.

Errores habituales

Guardar devuelve 401

• Comprueba que la API Key esté completa
• Copia el Model ID exacto de la model plaza.
• Comprueba el estado de la Key y el saldo en el Dashboard de BetterToken

Guardar devuelve 404

• La API Base URL debe ser https://bettertoken.ai/v1
• No añadas /chat/completions
• Asegúrate de que model name for API endpoint coincida exactamente con el ID de la model plaza

Dify indica que no encuentra el modelo

Model Name puede afectar a cómo Dify muestra y selecciona el modelo. model name for API endpoint controla el modelo real de la solicitud. Usa el mismo ID de modelo disponible en ambos campos.

El chat funciona, pero fallan las herramientas del Agent

Vuelve a establecer Function Call Type en Not Support y verifica un nodo LLM básico. Cámbialo a Tool Call solo cuando el modelo seleccionado admita llamadas a herramientas y vuelve a probar los argumentos.

Knowledge no puede usar este modelo como Embedding Model

Es el comportamiento esperado. Un LLM de chat no puede sustituir un modelo de embedding. Esta guía no confirma endpoints de embedding ni rerank de BetterToken para Dify; configura por separado un proveedor de embedding compatible para Knowledge.

Configuración avanzada

Guías relacionadas

• Model Providers de Dify

• Plugin oficial OpenAI-API-compatible de Dify

• API compatible con OpenAI frente a API compatible con Anthropic

• Cómo elegir un modelo

• Compara todas las herramientas compatibles

• Errores de API, códigos de estado y límites de solicitudes

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.