Dify API Handleiding 2026: AI via REST integreren in je app

Wat is de Dify API?

De Dify API is een REST API waarmee je elke in Dify gemaakte app programmatisch kunt aanroepen — vanuit elke programmeertaal of platform. Zodra je een Dify-app publiceert (chatbot, agent, workflow of completion-app), krijgt die een eigen API-endpoint dat je kunt aanroepen met een geheime sleutel.

De basis-URL voor Dify Cloud is https://api.dify.ai/v1. Bij zelf hosten vervang je die door je eigen domein: https://jouw-server.com/v1.

Typische gebruiksscenario's

Overzicht van API-endpoints

De Dify API biedt endpoints voor het verzenden van berichten, beheren van gesprekken, uploaden van bestanden en meer. Alle endpoints zijn relatief aan de basis-URL https://api.dify.ai/v1.

Streaming-antwoorden (SSE)

Streaming maakt het mogelijk om tokens te tonen terwijl ze worden gegenereerd — zoals het tik-effect bij ChatGPT. Dify gebruikt Server-Sent Events (SSE) voor streaming. Stel "response_mode": "streaming" in de request-body in.

Elk event komt aan als een regel met het voorvoegsel data:. De event-typen omvatten message (een token-chunk), message_end (afsluitend bericht met metadata) en error.

Streaming curl-voorbeeld

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer JOUW_API_KEY' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "Schrijf een kort gedicht over AI.",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "gebruiker-123"
  }'

Python streaming-voorbeeld

import requests
import json

def stream_chat(query, user="gebruiker-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer JOUW_API_KEY",
            "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("Leg kwantumcomputing eenvoudig uit.")

JavaScript / Browser (fetch met ReadableStream)

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

  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("uitvoer").textContent += data.answer;
        }
      }
    }
  }
}

streamChat("Wat zijn de voordelen van zelf-gehoste AI?");

Veelgestelde vragen