# Dify

Dify conecta con cualquier servicio compatible con OpenAI a través del proveedor de modelos OpenAI-API-compatible. Añade cada modelo por separado y cambia algunos valores predeterminados.

> https://nezhagate.com/es/docs/integrations/dify

Escrita con Dify 1.17 · OpenAI-API-compatible 0.0.68

## Antes de empezar

- Una cuenta de propietario o administrador del espacio de trabajo; solo ellos pueden configurar proveedores de modelos.

- Instala **OpenAI-API-compatible** (el plugin oficial de langgenius) desde el Marketplace.

## Añade un modelo

Abre **Model Provider** (en Integraciones en las versiones más nuevas, en Configuración en las antiguas), haz clic en **Add Model** en la tarjeta de OpenAI-API-compatible y rellena el formulario como se indica abajo:

| Campo | Qué poner |
| --- | --- |
| **Model Type** | LLM |
| **Model Name** | El ID exacto del modelo, como `gpt-5.5` |
| **API Key** | Tu clave de API de NezhaGate |
| **API Base URL** | `https://nezhagate.com/v1` |
| **Completion mode** | Chat |
| **Model context size** | La longitud de contexto real del modelo (consulta la documentación de su API). **El valor por defecto es 4096**; si no lo cambias, las conversaciones largas se cortarán. |
| **Upper bound for max tokens** | El máximo de tokens de salida del modelo; esto también usa 4096 por defecto. |
| **Function Call Type** | **Tool Call** para los modelos con llamadas a herramientas. El valor por defecto, Not Support, impide que los agentes llamen a herramientas. |
| **Vision Support** | Support, para los modelos que aceptan entrada de imágenes. |
| **API Type** | Deja **Chat Completions API**. |

La dirección debe incluir `/v1`: el plugin añade `/chat/completions` directamente. Deja los demás campos con sus valores por defecto.

## Claude (opcional)

También puedes instalar el plugin oficial **Anthropic**, poner `https://nezhagate.com/anthropic` en **API URL**, y añadir los modelos Claude uno a uno con **Add Model** (como `claude-sonnet-5`).

## Prueba

Al guardar se envía una petición muy corta para validar (se cobra según ese uso mínimo). Después, crea un chatbot en **Studio**, elige el modelo y envía un mensaje en la vista previa.

## Errores habituales

**Credentials validation failed with status code 404**

A la dirección le falta `/v1`; debería ser `https://nezhagate.com/v1`.

**Validation returns 401 or model not found**

401 significa que la clave está mal; model not found significa que el ID del modelo está mal escrito. Usa los ID de la [referencia de la API](https://nezhagate.com/es/docs/api).

**The agent never calls tools**

**Function Call Type** sigue en Not Support en el formulario del modelo; cámbialo a Tool Call.

**Long answers or conversations get cut**

**Model context size** y **Upper bound for max tokens** siguen en 4096; sube ambos a los valores reales del modelo.