Dify
Plataforma open-source para desarrollo de apps LLM con flujos de trabajo, RAG y agentes
Introducción
Dify es una plataforma visual de desarrollo de aplicaciones LLM. Al conectarla al endpoint compatible con OpenAI de TokenMix, puedes usar Claude, GPT-5, DeepSeek, Qwen y todos los modelos disponibles en TokenMix dentro de tus workflows de Dify, chatbots y pipelines RAG, sin configuración adicional en el lado del modelo.
Requisitos previos
Necesitas una instancia de Dify auto-hospedada. La forma más rápida es Docker Compose:
git clone https://github.com/langgenius/dify.git
cd dify/docker
cp .env.example .env
docker compose up -d
Accede a Dify en http://localhost (puerto 80 por defecto). Crea una cuenta de administrador en el primer inicio.
También necesitas una clave API de TokenMix: ve a tokenmix.ai → Consola → API Keys y crea una nueva clave.
Pasos de configuración
Paso 1 — Abrir configuración del proveedor de modelos
En tu espacio de trabajo de Dify, haz clic en tu avatar (arriba a la derecha) → Configuración → Proveedor de modelos.
Paso 2 — Agregar proveedor compatible con OpenAI-API
Desplázate hasta OpenAI-API-compatible y haz clic en Agregar modelo.
Paso 3 — Completar los datos de conexión
| Campo | Valor |
|---|---|
| URL del endpoint API | https://api.tokenmix.ai/v1 |
| Clave API | Tu clave TokenMix (sk-tm-…) |
| Nombre del modelo | ej. claude-sonnet-4.6 |
| Tipo de modelo | LLM |
| Modo de completado | Chat |
| Ventana de contexto | Según el modelo (200000 para Claude Sonnet) |
Haz clic en Guardar. Dify validará las credenciales automáticamente.
Paso 4 — Agregar modelo de embedding (para RAG)
Repite los pasos 2-3 cambiando el Tipo de modelo a Text Embedding e ingresando un modelo de embedding disponible en TokenMix (filtra por type=embedding en la página de Modelos, ej. text-embedding-3-large).
Paso 5 — Usar en un workflow o chatbot
Crea o abre una aplicación → en el selector de modelos, elige el modelo que acabas de agregar. Dify ahora enruta las solicitudes a través de TokenMix.
Verificación
Usa el panel "Depurar y previsualizar" de Dify para enviar un mensaje de prueba. Una respuesta exitosa confirma la integración.
También puedes verificar en Consola TokenMix → Uso que la solicitud haya sido registrada.
Preguntas frecuentes
P: Después de agregar el modelo, Dify muestra "Cuota superada" o "Clave API no válida". R: Vuelve a verificar tu clave en Configuración → Proveedor de modelos — pégala de nuevo para evitar espacios adicionales. Asegúrate también de que tu saldo en TokenMix sea positivo.
P: ¿Qué modelos de embedding admite TokenMix?
R: Ve a tokenmix.ai → Modelos y filtra por tipo Embedding. Las opciones comunes son text-embedding-3-large y text-embedding-3-small. Usa el short_id que aparece en la página como nombre del modelo en Dify.
P: ¿Puedo agregar varios modelos (Claude + GPT-5) al mismo tiempo?
R: Sí. Repite el paso "Agregar modelo" para cada modelo. La base_url y la clave API son las mismas; solo cambia el nombre del modelo y la ventana de contexto.