メインコンテンツへスキップ
POST

承認

Authorization
string
header
必須

すべてのリクエストは API キーで認証します：Authorization: Bearer {API_KEY}。アプリのエンドポイントにはアプリの API キーを、ナレッジのエンドポイントにはナレッジベースの API キーを使用します（Dify API クイックスタート）。

キーはサーバーサイドで保管し、クライアントコードには決して埋め込まないでください。キーがない、または無効な場合は HTTP 401（unauthorized）が返ります。

ヘッダー

X-Trace-Id
string

ボディの trace_id と同じです。最初に読み取られます。

X-Trace-Session-Id
string

ボディの trace_session_id と同じです。最初に読み取られます。

クエリパラメータ

trace_id
string

ボディの trace_id と同じです。ヘッダーの次に読み取られます。

trace_session_id
string

ボディの trace_session_id と同じです。ヘッダーの次に読み取られます。

ボディ

application/json
inputs
object
必須

アプリの入力変数の値を、変数名をキーとして指定します。対象環境に現在デプロイされているバージョンの入力変数に従って値を渡してください。

単一ファイル変数にはファイルオブジェクトを、ファイルリスト変数にはその配列を渡します。各オブジェクトの構造は files の各要素と同じです。

user
string
必須

エンドユーザーの識別子。アプリ側で定義し、アプリ内で一意にします。この値でデータへのアクセス範囲が決まります。ワークフロー実行とそのファイルは、同じ user を指定した後続のリクエストからのみ参照できます。エンドユーザーの識別 を参照してください。

response_mode
enum<string>
デフォルト:blocking

レスポンスをどう返すかを指定します。

  • streaming：実行が生成したイベントが順次届きます。短い応答以外はこちらを使います。
  • blocking：実行の完了後に 1 つのレスポンスを返します。
利用可能なオプション:
streaming,
blocking
files
object[] | null

ワークフローに渡すファイルです。ローカルファイルの場合は、まず ファイルをアップロード でアップロードし、返された id を upload_file_id として transfer_method: local_file で指定します。

受け付けるかどうかは、許可するタイプや個数など、ワークフロー自身のファイル設定で決まります。ファイルを受け付けないワークフローでは、これらの項目は無視されます。

trace_id
string

可観測性データに伝播されるトレース識別子です。英数字、ハイフン、アンダースコアを 128 文字まで使用できます。条件に合わない値は、エラーにならず読み飛ばされます。

trace_session_id
string

可観測性データに伝播されるトレースセッション識別子です。前後の空白を除いて 1〜200 文字です。

Required string length: 1 - 200

レスポンス

コンテンツタイプと構造はリクエストの response_mode パラメータに依存します。

  • response_mode が blocking の場合、application/json で WorkflowBlockingResponse オブジェクトを返します。
  • response_mode が streaming の場合、text/event-stream で ChunkWorkflowEvent オブジェクトのストリームを返します。
task_id
string<uuid>

この実行のタスク ID です。ブロッキングモードでは、最終レスポンスのボディにのみ含まれます。そのため ワークフロータスクを停止 が実用的なのは、ストリーミングの場合だけです。

workflow_run_id
string<uuid>

このワークフロー実行の ID です。

data
object