Dify API Anleitung 2026: KI per REST in deine App integrieren

Was ist die Dify API?

Die Dify API ist eine REST API, mit der du jede in Dify erstellte App programmatisch aufrufen kannst — aus jeder Programmiersprache oder Plattform. Sobald du eine Dify-App veröffentlichst (Chatbot, Agent, Workflow oder Completion-App), erhält sie einen eigenen API-Endpunkt, den du mit einem Secret Key aufrufen kannst.

Die Basis-URL für Dify Cloud ist https://api.dify.ai/v1. Beim Self-Hosting ersetzt du diese durch deine eigene Domain: https://dein-server.com/v1.

Typische Anwendungsfälle

Übersicht der API-Endpunkte

Die Dify API bietet Endpunkte zum Senden von Nachrichten, Verwalten von Konversationen, Hochladen von Dateien und mehr. Alle Endpunkte sind relativ zur Basis-URL https://api.dify.ai/v1.

Streaming-Antworten (SSE)

Streaming ermöglicht es, Tokens während der Generierung anzuzeigen — wie der Tipp-Effekt bei ChatGPT. Dify verwendet Server-Sent Events (SSE) für Streaming. Setze "response_mode": "streaming" im Request-Body.

Jedes Event kommt als Zeile mit dem Präfix data: an. Die Event-Typen umfassen message (ein Token-Chunk), message_end (Abschlussnachricht mit Metadaten) und error.

Streaming curl-Beispiel

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer DEIN_API_KEY' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "Schreib ein kurzes Gedicht über KI.",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "nutzer-123"
  }'

Python Streaming-Beispiel

import requests
import json

def stream_chat(query, user="nutzer-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer DEIN_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("Erkläre Quantencomputing einfach.")

JavaScript / Browser (fetch mit ReadableStream)

async function streamChat(query) {
  const response = await fetch("https://api.dify.ai/v1/chat-messages", {
    method: "POST",
    headers: {
      "Authorization": "Bearer DEIN_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      inputs: {},
      query,
      response_mode: "streaming",
      conversation_id: "",
      user: "nutzer-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("ausgabe").textContent += data.answer;
        }
      }
    }
  }
}

streamChat("Was sind die Vorteile von Self-Hosted KI?");

Häufig gestellte Fragen