> 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 创建异步任务，返回任务 ID。      |
| Find Task                                   | 根据任务 ID 查询当前状态和输出。                 |
| Generate Text、Generate Image、Generate Video | 调用选定的 BeatAPI 模型；图片和视频可能返回异步任务 ID。 |
| Get Social Data                             | 调用选定的社媒数据动作，可能扣费。                  |
| Search Capabilities、Inspect Capability      | 发现能力并读取当前契约。                       |
| Run Capability、Get Capability Result        | 启动受支持的能力或读取已保存的结果。                 |

## 搭建 Zap

1. 添加 **BeatAPI → Create Music Video Task**，连接专用 BeatAPI API Key。
2. 映射必需的公开 HTTPS 图片、音频 URL 与创作提示词。
3. 测试创建动作，把返回的 task ID 保存给后续步骤。
4. 先用 **Delay by Zapier** 等待，再调用 **BeatAPI → Find Task**；重复查询需有次数或时间上限。
5. 只有任务成功后才使用托管结果；保留失败或超时记录以便对账。

使用文本、图片、视频或社媒数据动作时，先在 Zap 编辑器核对具体模型和字段。动态能力应将 Search 的 `reference` 原样传给 Inspect；只有 Inspect 表明支持执行时才调用 Run。其他能力可按 Zapier 套餐所支持的 HTTP/Webhooks 工具调用 [BeatAPI API 文档](/api-reference)。2026 年 9 月 26 日，已通过 Zapier 远程调用验证推广版 v1.1.0 的 Search、Inspect 和一次短文本生成；其他模型和字段映射仍需逐项执行检查。

密钥保存在 Zapier 连接中。创建动作成功只表示任务已接受，不表示视频完成；向下游交付或发布前必须再次查状态。