Guide API Dify 2026 : Intégrez l'IA dans votre app avec REST

Qu'est-ce que l'API Dify ?

L'API Dify est une API REST qui vous permet d'appeler par programme n'importe quelle app créée dans Dify — depuis n'importe quel langage de programmation ou plateforme. Une fois que vous publiez une app Dify (chatbot, agent, workflow ou app de complétion), elle obtient son propre endpoint API que vous pouvez appeler avec une clé secrète.

L'URL de base pour Dify Cloud est https://api.dify.ai/v1. Si vous auto-hébergez Dify, remplacez-la par votre propre domaine : https://votre-serveur.com/v1.

Cas d'usage courants

Aperçu des endpoints API

L'API Dify fournit des endpoints pour envoyer des messages, gérer les conversations, uploader des fichiers et plus. Tous les endpoints sont relatifs à l'URL de base https://api.dify.ai/v1.

Réponses en streaming (SSE)

Le streaming vous permet d'afficher les tokens au fur et à mesure de leur génération — comme l'effet de frappe de ChatGPT. Dify utilise les Server-Sent Events (SSE) pour le streaming. Définissez "response_mode": "streaming" dans le corps de votre requête.

Chaque événement arrive comme une ligne préfixée par data:. Les types d'événements incluent message (un chunk de token), message_end (message final avec métadonnées) et error.

Exemple curl en streaming

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer VOTRE_CLE_API' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "Écris un court poème sur l'IA.",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "utilisateur-123"
  }'

Exemple Python en streaming

import requests
import json

def stream_chat(query, user="utilisateur-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer VOTRE_CLE_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("Explique l'informatique quantique simplement.")

JavaScript / Navigateur (fetch avec ReadableStream)

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

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

streamChat("Quels sont les avantages de l'IA auto-hébergée ?");

Questions fréquentes