Dify

Dify es una plataforma para construir apps de LLM — chatbots, workflows y agentes — en un editor visual. Su proveedor de modelos OpenAI-API-compatible acepta una base URL personalizada, así que tu stack aparece en todos los selectores de modelo del workspace.

Requisitos previos#

• Una clave de la página Claves de API de tu stack. Consulta Autenticación.
• El id del modelo que quieres llamar — consulta Modelos. Los ejemplos de abajo usan qwen/qwen3.5-9b.
• Permisos de admin del workspace en Dify, para añadir un proveedor de modelos.

Añade el modelo#

1. Abre los proveedores de modelos

   Haz clic en tu avatar → Settings → Model Provider. En versiones recientes la misma página está en Integrations → Model Provider.

2. Instala OpenAI-API-compatible

   Desde Dify 1.0 los proveedores son plugins. Si OpenAI-API-compatible no aparece en la lista, instálalo desde la sección Marketplace de la misma página.

3. Añade un modelo

   En la tarjeta del proveedor, haz clic en Add Model y completa:

   Campo	Valor
   Model Type	LLM
   Model Name	qwen/qwen3.5-9b
   API Key	Tu clave de Stac
   API Base URL	https://api.trystac.com/v1
   Completion mode	Chat
   Model context size	Auméntalo — el valor por defecto de Dify, 4096, es demasiado pequeño
   Function Call Type	Tool Call, si el modelo admite tool calling; si no, deja Not Support

   Deja los demás campos con sus valores por defecto. Las versiones antiguas del plugin llaman al campo de la URL API endpoint URL.

4. Guarda

   Dify valida las credenciales con una llamada de prueba antes de guardar. Un modelo guardado significa que la clave y la URL funcionan.

Ejemplo#

Crea una app Chatbot, elige qwen/qwen3.5-9b en el selector de modelo arriba a la derecha del editor y envía un mensaje en el panel Debug and Preview:

Tú:         Name three primary colors.
Assistant:  Red, blue, and yellow.

La solicitud aparece en Uso y Registros en el panel, igual que la de cualquier otro cliente.

Limitaciones#

• El nombre del modelo debe estar en tu plan. Escribe en Model Name el valor exacto de Modelos; un modelo que el plan de tu clave no incluye devuelve 403.
• Los agentes necesitan tool calling. Las apps de agente y los nodos de agente solo llaman tools cuando Function Call Type está configurado y el modelo admite tool calling.
• Las llamadas largas sin streaming expiran. Las apps con streaming funcionan bien; un nodo de workflow que espera la respuesta completa falla con 503 si la generación pasa de unos 90 segundos.
• Las instrucciones apagan la búsqueda automática. Cuando la app tiene instrucciones, Dify las envía como mensaje system, y una clave en Automático entonces omite la base de conocimientos. Ponla en Activada en la clave que usa Dify.
• Una completación por solicitud, logit_bias se descarta y el límite de tasa es por clave. Consulta Diferencias importantes.

Próximos pasos#

• Compatibilidad OpenAI — con qué habla el proveedor y qué cambia respecto a OpenAI.
• Base de conocimientos — cuándo usar la búsqueda de Stac en lugar de la función de conocimiento de Dify.
• Errores y límites de uso — qué códigos de estado reintentar.