Guía API Dify 2026: Integra IA en tu app con REST

¿Qué es la API Dify?

La API Dify es una API REST que te permite llamar programáticamente cualquier app creada en Dify — desde cualquier lenguaje de programación o plataforma. Una vez que publicas una app de Dify (chatbot, agente, workflow o app de completado), obtiene su propio endpoint API que puedes llamar con una clave secreta.

La URL base para Dify Cloud es https://api.dify.ai/v1. Si auto-hospedas Dify, reemplázala con tu propio dominio: https://tu-servidor.com/v1.

Casos de uso comunes

Resumen de endpoints de la API

La API Dify proporciona endpoints para enviar mensajes, gestionar conversaciones, subir archivos y más. Todos los endpoints son relativos a la URL base https://api.dify.ai/v1.

Respuestas en streaming (SSE)

El streaming te permite mostrar tokens a medida que se generan — como el efecto de escritura de ChatGPT. Dify usa Server-Sent Events (SSE) para el streaming. Establece "response_mode": "streaming" en el cuerpo de tu solicitud.

Cada evento llega como una línea con el prefijo data:. Los tipos de evento incluyen message (un chunk de token), message_end (mensaje final con metadatos) y error.

Ejemplo curl con streaming

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer TU_CLAVE_API' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "Escribe un poema corto sobre la IA.",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "usuario-123"
  }'

Ejemplo Python con streaming

import requests
import json

def stream_chat(query, user="usuario-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer TU_CLAVE_API",
            "Content-Type": "application/json",
        },
        json={
            "inputs": {},
            "query": query,
            "response_mode": "streaming",
            "conversation_id": "",
            "user": user,
        },
        stream=True,
    ) as response:
        for line in response.iter_lines():
            if line and line.startswith(b"data: "):
                data = json.loads(line[6:])
                if data.get("event") == "message":
                    print(data["answer"], end="", flush=True)
                elif data.get("event") == "message_end":
                    print()
                    break

stream_chat("Explica la computación cuántica de forma sencilla.")

JavaScript / Navegador (fetch con ReadableStream)

async function streamChat(query) {
  const response = await fetch("https://api.dify.ai/v1/chat-messages", {
    method: "POST",
    headers: {
      "Authorization": "Bearer TU_CLAVE_API",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      inputs: {},
      query,
      response_mode: "streaming",
      conversation_id: "",
      user: "usuario-navegador",
    }),
  });

  const reader = response.body.getReader();
  const decoder = new TextDecoder();

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    const lines = decoder.decode(value).split("\n");
    for (const line of lines) {
      if (line.startsWith("data: ")) {
        const data = JSON.parse(line.slice(6));
        if (data.event === "message") {
          document.getElementById("salida").textContent += data.answer;
        }
      }
    }
  }
}

streamChat("¿Cuáles son las ventajas de la IA auto-hospedada?");

Preguntas frecuentes