# Make ワークフロー

> WayinVideo API と Make を接続し、AI クリッピング、ウェビナー要約、バッチ処理、多言語出力向けの高度な動画自動化シナリオを構築します。

## Make 動画自動化連携

**Make** を使うと、分岐ロジック、イテレーター、ルーター、フィルター、リトライ、多段階のデータマッピングを含む高度な WayinVideo ワークフローを構築できます。

Make は、多数の動画を処理したい場合、成功タスクと失敗タスクを別ルートに分けたい場合、またはキャンペーン、言語、ソース、コンテンツタイプに応じて異なる WayinVideo API を実行したい場合に適しています。

WayinVideo API と Make の HTTP モジュールを使えば、バッチ AI クリッピング、ウェビナーの再利用、ローカライズされた要約、コンテンツレビューキュー、動画から CMS へのパイプラインを自動化できます。

> WayinVideo 専用の Make アプリは不要です。WayinVideo API キーを使い、Make の **HTTP** モジュールから接続できます。

---

## Make で自動化できること

- **動画クリッピングのバッチ処理**: Google Drive フォルダーを監視し、各動画を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送信して、完了したクリップをストレージまたはレビュー先へルーティングします。
- **ウェビナーの再利用**: [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) と [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) で、ウェビナー録画から要約、ハイライト、ショートクリップを生成します。
- **多言語動画ワークフロー**: `target_lang` を使い、ローカライズされた要約、文字起こし、クリップメタデータを作成します。
- **エクスポートワークフロー**: [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) を使い、選択したクリップを後からカスタム字幕、リフレーム、エクスポート設定でレンダリングします。

---

## 仕組み

多くの Make シナリオは、次の流れになります。

1. **トリガー**: 新しいファイル、レコード、webhook payload、またはスケジュールされたシナリオがワークフローを開始します。
2. **送信**: HTTP モジュールが WayinVideo API endpoint にリクエストを送信します。
3. **保存**: 返されたタスク `id` を後続のポーリング用に保存します。
4. **ポーリング**: スケジュールチェック、ループ、シナリオ設計を使い、タスクが `SUCCEEDED` または `FAILED` になるまで result endpoint を呼び出します。
5. **ルーティング**: ルーターとフィルターを使い、完了結果、失敗、リトライ経路を別々のモジュールへ送ります。

タスクステータスを確認する場合は、**30 秒**ごとのポーリングをおすすめします。

---

## 例: Google Drive の動画をバッチ処理する

このワークフローでは、ローカルファイルには [Upload API](https://wayin.ai/ja/api-docs/upload/) を使い、[AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) でショート動画クリップをまとめて生成します。

トリガー:
Google Drive フォルダー内の新しいファイル。

手順:
1. フォルダーを監視し、新しい動画ファイルを検知します。
2. 必要に応じて、各ファイルを [Upload API](https://wayin.ai/ja/api-docs/upload/) でアップロードします。
3. Iterator を使い、各動画を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送信します。
4. 返された各タスク `id` を保存します。
5. 各タスクをポーリングし、完了した結果を次のステップへルーティングします。
6. クリップ、メタデータ、`export_link` の値を Google Drive、Airtable、または CMS に保存します。

最適な用途:
多数の動画をバッチで処理する代理店、コンテンツスタジオ、チーム。

### 送信リクエスト

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/clips \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "enable_export": true,
    "resolution": "HD_720",
    "enable_caption": true,
    "enable_ai_reframe": true,
    "ratio": "RATIO_9_16"
  }'
```

---

## 例: ウェビナーコンテンツを結果に応じてルーティングする

このワークフローでは [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) を使ってウェビナーの要約を作成し、必要に応じて同じ録画を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送ってショートクリップを生成できます。

トリガー:
フォーム、CRM、またはストレージフォルダーから届く新しいウェビナー録画 URL。

手順:
1. 録画を [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) に送信します。
2. 結果をポーリングします。
3. 成功したタスクを Slack、HubSpot、Notion、Google Sheets に送ります。
4. 失敗したタスクをエラーログに送り、ワークフロー管理者へ通知します。
5. 必要に応じて、同じ動画を [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) に送信し、ショートクリップを作成します。

最適な用途:
ウェビナーを営業メモ、要約、SNS クリップに再利用する B2B マーケティングチーム。

### 結果確認

```bash
curl -X GET https://wayinvideo-api.wayin.ai/api/v2/summaries/results/sum_proj_001 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2"
```

レスポンスに `status: "SUCCEEDED"` が含まれる場合は、後続モジュールへ進みます。`status: "FAILED"` が含まれる場合は、存在すれば `error_message` を確認し、シナリオをリトライ、アラート、または手動レビューのステップへルーティングします。

---

## 例: ローカライズされた出力を生成する

このワークフローでは、[Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/)、[Video Transcription API](https://wayin.ai/ja/api-docs/video-transcription/)、または [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) と `target_lang` を使い、ローカライズされた出力を作成します。

トリガー:
キャンペーンキューに追加された新しい動画。

手順:
1. キャンペーンの対象言語リストを作成します。
2. Iterator を使い、同じ動画を `target_lang` ごとに 1 回ずつ送信します。
3. 各ロケール向けに要約、文字起こし、クリップメタデータを生成します。
4. 各結果を適切な地域別ワークスペース、シート、レビューキューへルーティングします。

最適な用途:
多言語の動画要約、文字起こし、クリップ説明が必要なグローバルコンテンツチーム。

### ローカライズ要約リクエスト

```bash
curl -X POST https://wayinvideo-api.wayin.ai/api/v2/summaries \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "x-wayinvideo-api-version: v2" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=example",
    "source_lang": "en",
    "target_lang": "ja"
  }'
```

---

## 推奨 API

| ワークフローの目的 | API |
|-------------------|-----|
| 長尺動画をショートクリップに変換 | [AI Clipping API](https://wayin.ai/ja/api-docs/ai-clipping/) |
| 自然言語クエリで特定の瞬間を検索 | [Find Moments API](https://wayin.ai/ja/api-docs/find-moments/) |
| 構造化された動画概要とタイムラインハイライトを生成 | [Video Summarization API](https://wayin.ai/ja/api-docs/video-summarization/) |
| タイミングと話者ラベル付きの文字起こしを抽出 | [Video Transcription API](https://wayin.ai/ja/api-docs/video-transcription/) |
| 処理前にローカル動画または音声ファイルをアップロード | [Upload API](https://wayin.ai/ja/api-docs/upload/) |
| 選択したクリップをレンダリングまたは再エクスポート | [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) |

---

## ベストプラクティス

- API キーは Make の接続設定または保護された変数に保存します。
- シナリオが複数回の実行にまたがる場合は、タスク ID をデータストア、シート、データベースに保存します。
- `SUCCEEDED`、`ONGOING`、`FAILED` の状態ごとにルーターを使います。
- プラットフォームのタイムアウトを避け、リトライ管理をしやすくするため、バッチサイズは小さめに保ちます。
- エクスポート済みクリップに長期アクセスが必要な場合は、`export_link` のファイルを自社ストレージにコピーします。

---

## FAQ

### WayinVideo には Make のネイティブアプリがありますか？

WayinVideo API は Make の **HTTP** モジュール経由で接続できます。専用の Make アプリは不要です。

### Make で WayinVideo の動画をバッチ処理できますか？

はい。Make の Iterator を使って複数の動画を WayinVideo に送信し、各タスク `id` を保存して、成功したタスクを次のモジュールへ送る前に結果をポーリングできます。

### Make で失敗した動画処理タスクを扱えますか？

はい。ルーターとフィルターで `SUCCEEDED`、`ONGOING`、`FAILED` のレスポンスを分けられます。失敗したタスクでは、存在すれば `error_message` を確認し、シナリオをリトライ、アラート、または手動レビューへルーティングします。

### Make で多言語の動画要約を作成できますか？

はい。同じ動画を異なる `target_lang` 値で送信し、地域チーム向けのローカライズされた要約、文字起こし、クリップメタデータを生成できます。