--- title: "Integración con Dify" description: "Configura 1折AI mediante el plugin oficial OpenAI-API-compatible de Dify, incluyendo la configuración del modelo, la prueba de conversación y la resolución de problemas de la primera llamada." headingIds: {"Requisitos previos":"section-1","Agregar un modelo":"section-2","Comenzar con la primera conversación":"section-3","Importar el Chatflow de ejemplo":"section-4","Resolución de problemas":"section-5","Obtener ayuda con la integración":"section-6","Alcance de la verificación":"section-7","English / Русский":"section-8"} --- Los usuarios de Dify pueden configurar el endpoint compatible con OpenAI de 1折AI mediante el plugin oficial de modelos **OpenAI-API-compatible**. Primero verifica un modelo de texto y luego úsalo en los flujos de trabajo; no es necesario instalar plugins de terceros no verificados. ## Requisitos previos - Un espacio de trabajo de Dify donde se puedan instalar plugins de modelos. - Tu propia clave API de 1折AI, además de los ID de modelos que esa clave está autorizada a invocar. Consulta la [consola](https://1zheai.com/console). - Saldo disponible suficiente en tu cuenta. La solicitud de validación al guardar un modelo y las pruebas de la aplicación pueden generar cargos normales de API. No envíes tu clave completa al servicio de atención al cliente, ni la escribas en descripciones de flujos de trabajo, capturas de pantalla o repositorios públicos. Guárdala únicamente en el campo API Key de Dify; si usas un Dify alojado por un tercero, esa instancia almacena tu clave y reenvía las solicitudes. ## Agregar un modelo 1. En el mercado de plugins de Dify, busca **OpenAI-API-compatible** y confirma que el editor es **langgenius**. 2. Abre los proveedores de modelos en la configuración del espacio de trabajo, localiza este plugin y agrega un modelo LLM. 3. Completa los campos siguientes y guarda. Las etiquetas de la interfaz pueden variar según la versión de Dify. | Campo | Cómo completarlo | | --- | --- | | Nombre del modelo | Copia el ID de modelo completo desde la consola de 1折AI; no lo sustituyas por el nombre para mostrar | | API Key | Tu propia clave de 1折AI | | API Base URL | `https://1zheai.com/v1` | | Modo de finalización | `Chat` | | Nombre del modelo en el endpoint de la API | Normalmente déjalo en blanco; si se establece, debe coincidir con el ID real del modelo | | Tamaño de contexto del modelo | Completa según la capacidad real del modelo seleccionado; no copies la longitud de contexto de otro modelo | Aquí necesitas `/v1`. No introduzcas el `/v1/chat/completions` completo, ni lo dupliques como `/v1/v1`. No apliques instrucciones de otros clientes que solo requieran la dirección raíz. ## Comenzar con la primera conversación Crea una aplicación de chat en blanco, selecciona el modelo que acabas de guardar e introduce «Presenta en una frase, en chino, qué puedes hacer». Una vez confirmada una respuesta de texto completa, verifica a continuación la salida en streaming. Consulta el tiempo de solicitud, el modelo y el resultado correspondientes en los registros de llamadas de la consola de 1折AI. No te limites a confiar en el «Guardado correctamente» de Dify como prueba de que la aplicación está conectada. Solo después del primer éxito debes configurar llamadas a herramientas, entrada visual o recuperación de la base de conocimientos; estas capacidades dependen del modelo y la interfaz concretos, y una conversación de texto exitosa no significa que todo esté disponible. ## Importar el Chatflow de ejemplo [Descarga la plantilla de Chatflow sin clave](/es/docs/downloads/1zheai-dify-chatflow.yml) y luego, en Dify Studio, elige **Crear → Importar archivo DSL** para subirla. La plantilla es `User Input → LLM → Answer`, versión de DSL 0.7.0, y usa el plugin oficial compatible 0.0.68. Primero agrega tus propias credenciales siguiendo los pasos anteriores. Después de importar, abre el nodo LLM y confirma que estén seleccionados tu propio proveedor y modelo, no el modelo de prueba de Dify. El ID de modelo de ejemplo es `claude-haiku-4-5-20251001`; si no está disponible para tu cuenta, cambia a un modelo al que tengas acceso y revisa la configuración de capacidades. La plantilla no contiene ninguna clave API y no proporciona créditos de llamada gratuitos. ## Resolución de problemas | Síntoma | Qué revisar primero | | --- | --- | | 503 / No hay cuentas disponibles | Es posible que el upstream actual esté limitado por tasa o sin capacidad. Revisa primero el estado del servicio y los registros de llamadas, reintenta más tarde con espera exponencial o contacta con el soporte; no reintentes de forma continua a alta frecuencia ni regeneres claves repetidamente | | 401 / Clave no válida | Si hay espacios extra, si la clave ha sido revocada y si se usó por error una clave de otra plataforma | | 404 | Si la Base URL es exactamente `https://1zheai.com/v1`; si el ID de modelo existe | | Modelo no permitido o saldo insuficiente | Las restricciones de modelo de la clave actual, el saldo disponible de la cuenta y el modelo seleccionado | | Guardado correctamente, pero la aplicación no puede llamar | Si la aplicación seleccionó el proveedor y el modelo correctos; si el servidor del espacio de trabajo puede alcanzar la API | | Las respuestas normales funcionan, pero el streaming falla | Revisa el soporte SSE del proxy, la versión del plugin y la configuración de uso de streaming; conserva un error redactado para la resolución de problemas | | Las llamadas a herramientas o la visión fallan | Primero confirma que el modelo seleccionado admite realmente esa capacidad; evita forzarla solo alternando los interruptores del plugin | Las solicitudes desde un Dify autoalojado las envía su servidor; el hecho de que tu navegador pueda abrir el sitio oficial no significa que el servidor de Dify pueda conectarse a la API. ## Obtener ayuda con la integración Proporciona la versión de Dify, la versión del plugin, el ID de modelo, la marca de tiempo del error, el ID de solicitud y los detalles redactados del error a través del servicio de atención al cliente en línea del sitio oficial. No envíes la clave completa, datos de clientes ni prompts privados de tus flujos de trabajo. ## Alcance de la verificación El 2026-10-19, con el plugin oficial 0.0.68, se completaron en Dify Cloud la conversación de texto y las llamadas en streaming de Haiku, y se contrastaron con los registros de la pasarela. El DSL sin clave exportado se importó en el mismo espacio de trabajo como una nueva aplicación. Tras la importación, una nueva prueba encontró un 503 causado por limitación de tasa del upstream, por lo que esta ronda no se registra como una ejecución posterior a la importación superada. Esta es una prueba interna con una ventana de tiempo definida, no una garantía de disponibilidad continua. No se han verificado espacios de trabajo nuevos, versiones anteriores de Dify, llamadas a herramientas, visión ni recuperación de la base de conocimientos; completa tu primera prueba con tu propia clave limitada por tasa. [Fuente oficial del plugin](https://github.com/langgenius/dify-official-plugins/tree/main/models/openai_api_compatible) · [Mercado de plugins de Dify](https://marketplace.dify.ai/) ## English / Русский **English:** Install the official OpenAI-API-compatible plugin by langgenius. Set API Base URL to `https://1zheai.com/v1`, use your own API key and an exact model ID available to your account, and select Chat mode. Test a simple conversation before adding tools or vision. Text and streaming calls were verified in Dify Cloud on 2026-10-19. DSL import into a new app in the same workspace succeeded; its subsequent run encountered an upstream-capacity 503. Fresh-workspace import and advanced capabilities remain unverified. Never share your key with support. **Русский:** Установите официальный плагин OpenAI-API-compatible от langgenius. Укажите API Base URL `https://1zheai.com/v1`, собственный API-ключ и точный ID модели, доступной вашему аккаунту; выберите режим Chat. Сначала проверьте простой диалог, затем потоковый вывод. Текстовые и потоковые вызовы проверены в Dify Cloud 19 октября 2026 года. Импорт DSL в новое приложение того же рабочего пространства прошёл, но повторный вызов вернул 503 из-за недоступной мощности upstream. Новое рабочее пространство и расширенные функции ещё не проверены. Не отправляйте ключ службе поддержки. Доступность из конкретной сети и способы оплаты проверяются отдельно.