> 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.

# 在 n8n 中使用 BeatAPI

> 在 n8n 中接入 BeatAPI 模型和数据，并按已验证范围导入具体任务工作流。

# 在 n8n 中使用 BeatAPI

先按任务选入口。模型凭证、HTTP 工作流和 n8n 已上架模板是不同的交付状态。

| 任务                          | n8n 入口                     | BeatAPI 接口                                            |
| --------------------------- | -------------------------- | ----------------------------------------------------- |
| AI Agent 或 LLM Chain 中的文本模型 | 内置 OpenAI Chat Model       | `https://api.beatapi.io/v1`，模型 ID 取自 `GET /v1/models` |
| 社媒数据或 Web 研究                | HTTP Request + Header Auth | 已检查契约的能力，或文档列出的 Data/Web 接口                           |
| 图片、视频、音乐视频                  | HTTP Request、Wait、有上限的状态轮询 | 只创建一次任务，保存任务 ID，再查询状态                                 |

## 配置凭证

内置 OpenAI Chat Model 使用 BeatAPI Key 和 Base URL `https://api.beatapi.io/v1`。HTTP Request 节点使用 Header Auth：Header 名称为 `Authorization`，值为 `Bearer <你的 BeatAPI Key>`。真实密钥只放在 n8n 凭证中，不写进导出的 JSON。

## 导入工作流

[BeatAPI n8n 示例目录](https://github.com/BeatAPI/beatapi-examples/tree/codex/n8n-capabilities/integrations/n8n)包含通用能力、三种公开社媒研究和音乐视频工作流。当前社媒数据改动位于 [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20)；PR 是待审核代码，不代表已合并或在 n8n 模板市场上架。

1. 下载 JSON 并导入 n8n。
2. 在 **Configure Inputs** 中替换示例输入。
3. 给所有 BeatAPI HTTP Request 节点绑定 Header Auth 凭证。
4. 付费调用前检查所选能力的输入、输出、价格和执行方式。
5. 跑一次真实执行，将 BeatAPI 的 request ID 或 task ID 与 n8n execution ID 一起保存。

异步任务应重试状态查询，不能因为一次查询失败就重新创建付费任务。成功、失败和等待超时都要有明确分支；n8n 等待超时不等于 BeatAPI 任务失败。

## 验证状态

截至 2026 年 9 月 26 日，三个社媒 JSON 已在本地 n8n 导入；X 关键词工作流完整跑通一次。Instagram 和 YouTube 完成了 API 与导入检查，尚无完整 n8n 执行记录。X 模板已提交 n8n Creator Portal 人工审核。最新分发状态请查看 [PR #20](https://github.com/BeatAPI/beatapi-examples/pull/20)和 n8n 模板目录。

这些示例使用 n8n 内置节点；BeatAPI 尚未发布专用 n8n 社区节点。