> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Zapier で BeatAPI を使う

> 公開されている BeatAPI の Zapier アプリに接続し、現在利用できるアクションを確認します。

# Zapier で BeatAPI を使う

[Zapier の公開 BeatAPI アプリ](https://zapier.com/apps/beatapi/integrations)では、現在、本番に昇格したバージョン 1.1.0 を使用しています。公開アクションには以下が含まれます。

| アクション                                       | 結果                                                         |
| ------------------------------------------- | ---------------------------------------------------------- |
| Create Music Video Task                     | 公開画像 URL と音声 URL から非同期タスクを 1 件作成し、タスク ID を返します。            |
| Find Task                                   | 既存のタスク ID の現在のステータスと出力を取得します。                              |
| Generate Text、Generate Image、Generate Video | 選択した BeatAPI モデルを呼び出します。画像や動画の作成では、非同期タスク ID が返される場合があります。 |
| Get Social Data                             | 選択した Social Data アクションを呼び出します。クレジットを消費する場合があります。           |
| Search Capabilities、Inspect Capability      | 機能を検索し、実行前に現在の仕様を確認します。                                    |
| Run Capability、Get Capability Result        | 対応する機能を実行するか、保存された結果を取得します。                                |

## Zap を作成する

1. **BeatAPI → Create Music Video Task** を追加し、専用の BeatAPI API キーを接続します。
2. 必須の公開 HTTPS 画像 URL、音声 URL、制作プロンプトをマッピングします。
3. アクションをテストし、次のステップでタスク ID を保存します。
4. **BeatAPI → Find Task** の前に **Delay by Zapier** を配置します。回数や時間を制限したスケジュール、または後続の Zap で、成功か失敗まで確認を繰り返します。
5. タスクの成功後にのみホストされた出力を利用します。失敗やタイムアウトした実行も、後で照合できるように残します。

テキスト、画像、動画、Social Data では、対応する BeatAPI アクションを選択し、Zap エディターでフィールドをテストしてください。動的な機能では Search の `reference` を変更せずに Inspect に渡し、Inspect が実行可能と示した場合にのみ Run を使います。その他の機能には、ご利用のプランで可能な範囲で、[BeatAPI API リファレンス](/api-reference)に対して Zapier の HTTP/Webhooks ツールを利用できます。2026 年 9 月 26 日には、本番の v1.1.0 に対する Zapier のリモート呼び出しで Search、Inspect、短い Generate Text の実行が成功しました。その他のモデルやフィールドのマッピングは、個別の実行検証が必要です。

API キーは Zapier の接続設定に保存してください。**Create** ステップの成功はタスクの受け付けを意味し、メディアの完成を意味しません。後続の配信や公開の前に、タスクのステータスを確認してください。