Saltar al contenido principal

​
Descripción general

Dify funciona bien con TokenLab a través de su flujo de proveedor de modelos compatible con OpenAI. Esta es una ruta de integración orientada a chat-completions. No debe interpretarse como una garantía de que Dify expone las mismas respuestas o comportamiento de WebSocket que las integraciones dedicadas de Codex. Para las versiones actuales de Dify, la ruta más segura suele ser:
  • elegir el proveedor OpenAI integrado
  • configurar tu API key de TokenLab
  • establecer una URL base personalizada de https://api.tokenlab.sh/v1
Algunas versiones antiguas de Dify exponen esto como OpenAI-API-compatible en lugar del proveedor OpenAI integrado con un campo de URL base personalizada. Si tu interfaz de Dify se ve diferente, utiliza el flujo de proveedor personalizado compatible con OpenAI más cercano disponible en esa versión.
Tipo: Framework o PlataformaRuta principal: Ruta de chat compatible con OpenAINivel de soporte: Soportado con límites de alcance

​
Requisitos previos

  • Cuenta de TokenLab con acceso a la API
  • Dify Cloud o Dify autohospedado

​
Pasos de configuración

​
Paso 1: Obtén tu API Key

  1. Inicia sesión en el TokenLab Dashboard
  2. Abre API Keys
  3. Crea o copia una API key que comience con sk-

​
Paso 2: Configura el proveedor

1

Abrir proveedores de modelos

En Dify, ve a Settings → Model Providers
2

Seleccionar OpenAI

Abre la configuración del proveedor OpenAI. Si tu versión de Dify no ofrece una URL base personalizada aquí, utiliza la opción de proveedor personalizado compatible con OpenAI expuesta por esa versión.
3

Ingresar la configuración de TokenLab

Utiliza estos valores:
CampoValor
API Keysk-your-tokenlab-key
API Base URL / Custom Base URLhttps://api.tokenlab.sh/v1
4

Agregar modelos

Agrega los modelos que deseas utilizar, por ejemplo:
  • gpt-5.4
  • gpt-5.4-mini
  • claude-sonnet-5
  • claude-opus-4-8
  • gemini-3.5-flash
  • gemini-3.1-flash-lite
  • deepseek-v4-flash

​
Paso 3: Probar la conexión

  1. Elige un modelo como gpt-5-mini o gpt-4o
  2. Envía un prompt de prueba
  3. Confirma que Dify recibe una respuesta válida

​
Embeddings para bases de conocimiento

Para RAG y la indexación de bases de conocimiento, agrega un modelo de embedding como:
  • text-embedding-3-small
  • text-embedding-3-large
Luego, configúralo como el modelo de embedding predeterminado en la base de conocimiento relevante o en la configuración de la aplicación.

​
Roles de modelo recomendados

Caso de usoModelos sugeridos
Chat predeterminadogpt-5.4-mini, gpt-5.4, claude-sonnet-5
Razonamiento profundogpt-5.5, gpt-5.4, claude-opus-4-8, deepseek-v4-pro
Rápido/económicogpt-5.4-mini, gemini-3.5-flash, deepseek-v4-flash
Embeddingstext-embedding-3-small, text-embedding-3-large

​
Mejores prácticas

En las versiones más recientes de Dify, el proveedor OpenAI integrado con una URL base personalizada suele ser la configuración más limpia para TokenLab.
Usa gpt-5.4-mini, gemini-3.5-flash o deepseek-v4-flash mientras iteras, luego cambia los flujos de trabajo más pesados a modelos más potentes solo cuando sea necesario.
La mayoría de los flujos de Dify utilizan un comportamiento de chat compatible con OpenAI. Si necesitas respuestas específicas de Codex o comportamiento de WebSocket, utiliza las integraciones dedicadas de Codex en lugar de Dify.

​
Solución de problemas

  • Verifica que la URL base sea exactamente https://api.tokenlab.sh/v1
  • Elimina las barras diagonales finales si Dify las duplica
  • Confirma que el servidor de Dify pueda acceder a TokenLab a través de la internet pública
  • Verifica nuevamente la API key
  • Confirma que la clave esté activa en el dashboard de TokenLab
  • Asegúrate de que el valor pegado en Dify no contenga espacios adicionales ni saltos de línea
  • Verifica el nombre del modelo exactamente
  • Vuelve a agregar la entrada del modelo si la interfaz del proveedor almacenó en caché un valor anterior
  • Verifica la disponibilidad actual del modelo en la documentación o el dashboard de TokenLab