Guida API Dify 2026: Integra l'IA nella tua app con REST

Cos'è l'API Dify?

L'API Dify è una API REST che ti permette di chiamare programmaticamente qualsiasi app creata in Dify — da qualsiasi linguaggio di programmazione o piattaforma. Una volta che pubblichi un'app Dify (chatbot, agente, workflow o app di completamento), ottiene il proprio endpoint API che puoi chiamare con una chiave segreta.

L'URL base per Dify Cloud è https://api.dify.ai/v1. Se ospiti Dify in autonomia, sostituiscila con il tuo dominio: https://tuo-server.com/v1.

Casi d'uso comuni

Panoramica degli endpoint API

L'API Dify fornisce endpoint per inviare messaggi, gestire conversazioni, caricare file e altro. Tutti gli endpoint sono relativi all'URL base https://api.dify.ai/v1.

Risposte in streaming (SSE)

Lo streaming ti permette di visualizzare i token man mano che vengono generati — come l'effetto di digitazione di ChatGPT. Dify usa Server-Sent Events (SSE) per lo streaming. Imposta "response_mode": "streaming" nel corpo della richiesta.

Ogni evento arriva come una riga con il prefisso data:. I tipi di evento includono message (un chunk di token), message_end (messaggio finale con metadati) e error.

Esempio curl con streaming

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer LA_TUA_CHIAVE_API' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "Scrivi una breve poesia sull'IA.",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "utente-123"
  }'

Esempio Python con streaming

import requests
import json

def stream_chat(query, user="utente-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer LA_TUA_CHIAVE_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("Spiega il quantum computing in modo semplice.")

JavaScript / Browser (fetch con ReadableStream)

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

streamChat("Quali sono i vantaggi dell'IA self-hosted?");

Domande frequenti