Dify APIガイド2026: RESTでアプリにAIを統合する

Dify APIとは？

Dify APIは、Difyで作成した任意のアプリをプログラムで呼び出せるREST APIです — 任意のプログラミング言語やプラットフォームから呼び出せます。Difyアプリ（チャットボット、エージェント、ワークフロー、補完アプリ）を公開すると、シークレットキーで呼び出せる固有のAPIエンドポイントが付与されます。

Dify CloudのベースURLはhttps://api.dify.ai/v1です。セルフホスティングの場合は自分のドメインに置き換えます：https://your-server.com/v1。

典型的なユースケース

APIエンドポイント一覧

Dify APIはメッセージの送信、会話の管理、ファイルのアップロードなどのエンドポイントを提供します。すべてのエンドポイントはベースURLhttps://api.dify.ai/v1からの相対パスです。

ストリーミングレスポンス（SSE）

ストリーミングにより、ChatGPTのタイピング効果のように生成中にトークンを表示できます。DifyはストリーミングにServer-Sent Events（SSE）を使用します。リクエストボディに"response_mode": "streaming"を設定してください。

各イベントはdata:プレフィックス付きの行として届きます。イベントタイプにはmessage（トークンチャンク）、message_end（メタデータ付きの完了メッセージ）、errorがあります。

ストリーミングcurlの例

curl -X POST 'https://api.dify.ai/v1/chat-messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --no-buffer \
  -d '{
    "inputs": {},
    "query": "AIについて短い詩を書いてください。",
    "response_mode": "streaming",
    "conversation_id": "",
    "user": "user-123"
  }'

Pythonストリーミングの例

import requests
import json

def stream_chat(query, user="user-123"):
    with requests.post(
        "https://api.dify.ai/v1/chat-messages",
        headers={
            "Authorization": "Bearer YOUR_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("量子コンピューティングをわかりやすく説明してください。")

Difyをセルフホストしてフルコントロール

DifyをセルフホストするとAPIが完全に自分の管理下に置かれます — 独自のサーバーで動作し、APIコストなし、レート制限なし、完全なデータプライバシー。Hetznerで月額€3.79から始められます。