Dify en Rusia: API compatible con OpenAI y tu primer workflow
Añade un proveedor de modelos compatible con OpenAI, crea un workflow mínimo de texto y compara la ejecución con el Dashboard del proveedor.
Índice
Dify puede conectar una API externa mediante su proveedor de modelos oficial OpenAI-API-compatible. Necesitas tu propia API Key, una Base URL compatible y un Model ID actual. Para verificar la configuración, crea un workflow con una entrada de texto, un nodo LLM y una salida de texto; ejecútalo una vez y compara el resultado con el registro del proveedor.
¿Necesita su propia API Key para este workflow? Cree una cuenta BetterToken
Para probar Dify con un solo workflow y sin acciones externas, usa una clave de prueba independiente de BetterToken y abre la guía actual de Dify. Cubre el acceso a la API de modelos. La instalación de Dify, Marketplace, los plugins de terceros, los agents y las tools siguen siendo capas independientes.
Qué necesitas preparar
- una instancia funcional de Dify Cloud o una instalación de Dify autoalojada;
- acceso a Integrations/Marketplace y Model Providers;
- tu propia API Key de BetterToken;
- un Model ID actual de la model plaza de BetterToken;
- un workflow de prueba nuevo, sin tools ni acciones externas.
Desde Rusia puedes conectarte al endpoint de la API de BetterToken sin VPN. Esto no garantiza la disponibilidad de Dify Cloud, Marketplace, GitHub, un registry de Docker ni plugins de terceros.
1. Instala el proveedor oficial
En Dify, abre Integrations o Marketplace y después Model Providers. Busca el proveedor oficial OpenAI-API-compatible e instálalo si aún no está disponible.
Comprueba el autor y la ficha en el Marketplace oficial de Dify. No uses un plugin cualquiera con un nombre parecido: los campos y el tratamiento de credentials pueden ser distintos.
2. Añade un modelo de BetterToken
Abre la configuración del proveedor y añade un nuevo modelo LLM. Completa lo siguiente:
- Model Type: LLM.
- Model Name / ID: el Model ID actual exacto.
- API Key: tu propia API Key de BetterToken.
- API Base URL:
https://www.bettertoken.ai/v1. - Completion mode: Chat, si lo requieren el proveedor y el modelo elegidos.
No añadas /chat/completions a la Base URL: el proveedor construye la ruta completa. No copies credentials reales en una exportación de la aplicación, una captura de pantalla o una issue.
Si la interfaz pide tamaño de contexto, max tokens, parámetros de visión o streaming, utiliza únicamente valores de la documentación actual del modelo. La primera prueba no necesita funciones adicionales.
3. Guarda y valida el credential
Dify valida el credential al guardarlo. Esto solo confirma que el proveedor completó su procedimiento de autenticación; no valida todo el workflow.
Después de un error, guarda solo datos de diagnóstico seguros:
- nombre y versión del proveedor;
- Model ID;
- Base URL sin la clave;
- tipo de error breve y estado HTTP;
- hora del intento.
No guardes la API Key ni una respuesta sensible completa.
4. Crea un workflow mínimo
Crea una nueva aplicación de tipo Workflow. Añade únicamente tres elementos:
- Start con una variable de texto llamada
question. - LLM con el modelo de BetterToken que añadiste.
- End con el texto de respuesta del LLM.
Usa esta plantilla simple de prompt para el LLM:
Responde en una sola línea. Entrada: {{question}}Conecta Start → LLM → End. No añadas herramientas HTTP, una base de datos, recuperación de conocimiento, un bucle de agent ni publicación. Hacen más difícil aislar el primer fallo.
5. Ejecuta una prueba
Introduce lo siguiente:
Devuelve DIFY_OK y el número 4 como suma de 2 + 2.La configuración queda confirmada cuando:
- Dify muestra la salida de texto esperada;
- el nodo LLM termina sin error de credential, modelo o endpoint;
- el Dashboard de BetterToken muestra un registro con el modelo y el estado esperados;
- el Dashboard muestra tokens de entrada, salida, cache cuando corresponda y el cargo asociado.
Comparar la ejecución de Dify con el Dashboard descarta que el workflow haya usado silenciosamente otro proveedor u otro modelo.
Cómo distinguir los errores
El proveedor o plugin no se instala
Esto pertenece a la capa de Dify Marketplace/plugin-daemon. En un entorno autoalojado, comprueba la versión de Dify, el acceso de red del plugin daemon, HTTPS y la cadena de certificados. Cambiar la API Key de BetterToken no solucionará este problema.
ToolProviderCredentialValidationError o 401
Introduce la clave otra vez, comprueba los espacios y verifica el proveedor seleccionado. Asegúrate de que el credential pertenece al modelo y no a un plugin de herramienta no relacionado.
404
Comprueba la Base URL:
https://www.bettertoken.ai/v1Elimina cualquier /chat/completions añadido manualmente si el campo espera una API Base URL.
model not found
Copia el ID actual desde la model plaza. Confirma que ese ID esté disponible para la clave nueva y el proveedor compatible con OpenAI seleccionado.
El credential se guarda, pero el workflow falla
Prueba solo el nodo LLM. Quita tools, streaming y salida estructurada; después repite la ejecución corta de texto de entrada/texto de salida. Si funciona, restaura los nodos adicionales uno a uno.
Alcance de esta configuración
El primer workflow confirma una solicitud de modelo mediante el proveedor oficial OpenAI-API-compatible. No demuestra compatibilidad con todos los agents de Dify, plugins comunitarios, tools ni servicios externos. Crea una prueba independiente para cualquier acción con efecto secundario y exige una confirmación explícita del usuario.
Los campos y límites actuales están en la documentación de BetterToken para Dify. Comprueba los Model IDs y precios dinámicos el día de la configuración.
