Higgsfield 开放 API 与 MCP 协议:赋能 n8n 与 Make 构建自动化视频生成工作流
随着 AI 视频生成技术从实验阶段走向商业化落地,代理机构(Agency)面临着规模化交付的严峻挑战。不同的客户简报(Brief)往往需要调用不同的生成模型,而传统模式下为每个模型单独管理 API Key 和集成方案,极大地增加了前期部署成本。
Higgsfield 作为 AI 原生创意套件,通过开放其 API 与 MCP(Model Context Protocol)协议,彻底改变了这一局面。开发者现在可以将 Higgsfield 无缝嵌入到 n8n 和 Make 工作流中,实现批量、自动化的视频生产,并将成品直接交付给最终用户。
核心突破:双轨制集成架构
Higgsfield 提供了两种主要集成路径,分别适配不同的业务场景:
-
Higgsfield API(预付费模式):
- 适用场景:高并发生产、独立运营的客户项目。
- 机制:开发者需单独在
open.higgsfield.ai创建 API 账户,使用预付费余额(美元)。 - 优势:支持调用 50+ 种模型,计费灵活,按生成次数结算,失败请求自动退款。
-
Higgsfield MCP(订阅模式):
- 适用场景:已拥有 Higgsfield 订阅的团队,追求零 Key 管理的便捷性。
- 机制:利用 MCP Client 节点,通过 OAuth2 认证直接关联现有 Higgsfield 账户。
- 优势:无需管理 API Key,生成结果直接存入 Higgsfield 的 Assets 库,支持批量处理与 Upscale 等高级工具。
技术实现:在 n8n 与 Make 中部署
1. 基于 API 的集成(异步工作流)
Higgsfield 的 API 调用遵循标准的异步四阶段流程:
- 提交请求:通过 HTTP POST 发送 Prompt 与参数,获取
request_id、status_url及cancel_url。 - 队列等待:请求进入处理队列,状态从
queued变为in_progress。 - 接收回调:系统通过
hf_webhook参数触发 Webhook,或开发者轮询status_url检查状态(completed/failed/nsfw/canceled)。 - 下载文件:获取最终输出 URL,建议将文件复制到本地存储,保留期至少 7 天。
在 n8n 中的配置示例:
- HTTP Request Node:设置 Header 为
Authorization: Key KEY_ID:SECRET,Body 包含 Prompt、Duration 等参数。 - Wait Node:配置
{{ $execution.resumeUrl }},确保工作流在生成完成时自动恢复。 - 代码片段:
POST https://api.higgsfield.ai/bytedance/seedance-2.5/text-to-video Headers: { "Authorization": "Key KEY_ID:SECRET" } Body: { "prompt": "A ceramic mug rotating...", "duration": 10, "resolution": "720p" }
在 Make 中的配置:
- 利用 HTTP Module 提交请求,并将生成的
hf_webhook地址填入第二个场景的 Custom Webhook 触发器。 - 第二个场景接收回调 payload,提取输出 URL 并执行后续分发逻辑。若需轮询,可在两个场景间插入 Sleep 模块检查
status_url。
2. 基于 MCP 的集成(无 Key 模式)
对于已订阅用户,MCP 提供了更优雅的体验:
- n8n 集成:添加 MCP Client 节点,设置 Server Transport 为
HTTP Streamable,Endpoint 指向https://mcp.higgsfield.ai/mcp,认证方式选择MCP OAuth2。 - 交互方式:登录后,工作流可直接调用
generation、batch、upscale等工具,参数统一通过 JSON 字段传递(如{"model": "soul_2", "prompt": "..."})。 - 状态管理:通过
jobs_wait工具获取 Job ID,实时追踪生成进度。
商业价值与应用前景
此次更新标志着 Higgsfield 正式从单一生成工具转型为自动化视频生产引擎。对于 AI 视频代理机构而言,这意味着:
- 降低门槛:无需为每个模型单独集成,统一账户管理即可覆盖 50+ 种模型(涵盖 Seedance, Kling, Veo 3.1 等)。
- 商业合规:生成的视频可直接用于商业用途,满足客户版权需求。
- 灵活计费:API 模式支持按量付费,MCP 模式则与订阅深度绑定,满足不同规模团队的需求。
正如 Higgsfield 团队所言,"The whole pipeline runs through one account",这一架构重构不仅解决了规模化生产的瓶颈,更为 AI 视频内容的工业化分发奠定了坚实的技术基础。