> ## Documentation Index
> Fetch the complete documentation index at: https://enterprise-docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow アプリ API

> ワークフロー実行、実行制御とストリーミング、人間の入力による一時停止、実行履歴を扱う Workflow アプリ向けの API

[Workflow アプリ](https://enterprise-docs.dify.ai/ja/3.13.x/use/build/workflow-chatflow.md) は `workflow` モードで動作します。呼び出しごとに公開済みのワークフローを 1 回実行し、その出力を返します。呼び出し間で会話状態を保持しないため、各実行は独立しています。

> [!NOTE]
>
> 認証、ベース URL、エンドユーザーごとにデータを区分する `user` フィールドについては、[クイックスタート](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/guides/get-started.md) と [エンドユーザーの識別](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/guides/end-user-identity.md) を参照してください。

## ワークフローの実行

* **[ワークフローを実行](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/run-workflow.md)**：指定した入力変数で、アプリの現在公開中のワークフローを実行します。

  ストリーミングモードでは、ノードの実行に合わせてイベントをリアルタイムに受け取れます。ブロッキングモードでは、実行が完了してから結果を返します。
* **[ID でワークフローを実行](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/run-workflow-by-id.md)**：特定の公開バージョンを実行します。`workflow_id` は、以前の実行レスポンスや実行詳細の取得結果にあります。

## 実行の追跡と制御

どちらのモードでも、レスポンスには 2 つの ID が含まれます。`task_id` は実行中のタスクを制御し、`workflow_run_id` は実行後に保存される記録を識別します。

* **[ワークフロータスクを停止](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/stop-workflow-task.md)**：`task_id` を指定して実行中のタスクを取り消します。ストリーミングモードでのみ有効です。ブロッキングモードでは、レスポンスが返る時点で実行が完了しているため取り消せません。
* **[ワークフローイベントをストリーム](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/stream-workflow-events.md)**：接続の切断後や一時停止後に、`workflow_run_id` からイベントストリームを再開します。

  `include_state_snapshot=true` を指定すると、実行済みノードの状態を先に再生します。`continue_on_pause=true` を指定すると、複数回の人間の入力による一時停止をまたいでストリームを維持できます。

## 人間の入力による一時停止

配信方法に Web アプリを指定した [人間の入力](https://enterprise-docs.dify.ai/ja/3.13.x/use/nodes/human-input) ノードに実行が到達したら、API で一時停止を完了させます。

**1. 一時停止の検知**

実行のイベントストリームが `form_token` と実行の `workflow_run_id` を含む `human_input_required` を発行します。その後、ストリームは `workflow_paused` イベントで終了します。

**2. フォームの取得**

`form_token` を使い、[人間の入力フォームを取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/human-input/get-human-input-form.md) でフォームの内容を読み込みます。

**3. 回答の送信**

[人間の入力フォームを送信](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/human-input/submit-human-input-form.md) で受信者の入力内容を送信します。送信すると実行が再開します。

**4. ストリームの再開**

一時停止したストリームの `workflow_run_id` を使い、[ワークフローイベントをストリーム](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/stream-workflow-events.md) で新しいストリームを開きます。実行完了までの残りのイベントを追跡します。

ファイルを添付した送信と完全なイベントシーケンスについては、[人間の入力フロー](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/guides/human-input-flow.md) ガイドを参照してください。

## 実行履歴の確認

* **[ワークフロー実行詳細を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/get-workflow-run-detail.md)**：指定した `workflow_run_id` の実行ステータスと出力を返します。
* **[ワークフローログ一覧を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/list-workflow-logs.md)**：ステータス、token 使用量、ステップ数、所要時間を含む実行単位のサマリーを返します。ノード単位の実行ログではありません。キーワード、ステータス、期間、実行を開始したユーザーで絞り込めます。

ノード単位のイベントが必要な場合は、ログではなく実行自体をストリームします。新しく開始する実行は、[ワークフローを実行](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/run-workflow.md) をストリーミングモードで呼び出します。進行中の実行には、[ワークフローイベントをストリーム](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/workflow-runs/stream-workflow-events.md) を使用します。

## ファイルの操作

* **[ファイルをアップロード](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/files/upload-file.md)**：画像、ドキュメント、音声、動画ファイルをアップロードします。ワークフローの実行時に、ファイル型の入力変数へ返された `id` を `upload_file_id` として渡します。ファイルはアップロードしたエンドユーザーのみが利用できます。
* **[エンドユーザー取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/end-users/get-end-user-info.md)**：エンドユーザー ID（ファイルアップロードのレスポンスにある `created_by` など）から、そのユーザーの詳細を取得します。

## 音声とテキストの相互変換

* **[音声をテキストに変換](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/audio/convert-audio-to-text.md)**：アップロードされた音声ファイル（MP3、M4A、WAV、AMR、MPGA のいずれか、最大 30 MB）を文字起こしします。エンドユーザーは入力値をタイピングの代わりに音声で入力できます。
* **[テキストを音声に変換](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/audio/convert-text-to-audio.md)**：ワークフローのテキスト出力を音声として合成します。

## アプリ情報と設定の取得

* **[アプリケーションの基本情報を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/applications/get-app-info.md)**：アプリの名前、説明、タグ、モードを返します。
* **[アプリケーションのパラメータ情報を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/applications/get-app-parameters.md)**：呼び出し時に `inputs` で送るフィールド（名前、型、デフォルト値）と、アプリの機能スイッチを返します。リクエストやクライアント UI を構築する際の基礎になります。
* **[アプリケーションのメタ情報を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/applications/get-app-meta.md)**：ツールアイコンなどの設定メタデータを返します。
* **[アプリの Web アプリ設定を取得](https://enterprise-docs.dify.ai/ja/3.13.x/develop/api/applications/get-app-webapp-settings.md)**：Web アプリのサイト設定、テーマ、カスタマイズ項目を返します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.