Ajustes principales
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
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
1
Abre Model Providers
En el workspace de Dify, ve a Integrations > Model Providers.
2
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.
3
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.Introduce la configuración del modelo
Usa estos valores para el primer modelo:
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 Supportpara 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
Usa el modelo en una aplicación
1
Crea o abre una aplicación de Dify
Abre un Chatbot, Agent, Chatflow o Workflow.
2
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.
3
Prueba primero el chat básico
Ejecuta la primera solicitud con una entrada de texto breve, sin herramientas ni imágenes:
4
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 campoModel 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 de un proveedor compatible, 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
- Confirma que el ID del modelo proceda del proveedor compatible
- Comprueba el estado de la Key y el saldo en el Dashboard de BetterToken
Guardar devuelve 404
- La API Base URL debe ser
https://www.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 de un proveedor compatible en ambos campos.El chat funciona, pero fallan las herramientas del Agent
Vuelve a establecer Function Call Type enNot 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
Proveedores compatibles
Los estados se aplican al método de configuración de BetterToken descrito en esta página.
Qué significa cada método de configuración
Qué significa cada método de configuración
- 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
- 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
Detalles técnicos
Protocolo, endpoint y campos internos del proveedor
Protocolo, endpoint y campos internos del proveedor
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.