API 集成

用 n8n 生成海报和视频

用 HTTP Request 节点提交模板任务，等拿到实际成品，再交给下一步处理。

约 4 分钟API 接入

下方提示词和代码保留原文。复制后，把示例中的占位值换成自己的资料。

本页目录

开始前 1. 先发一个只读请求 2. 把提交所需的信息记下来 3. 提交制作 4. 等任务完成 5. 检查成品，再交给下一步频率限制和恢复

开始前

准备有权限的工作台账号、保存好的海报或视频模板、授权素材、完整输入和 n8n 工作区。渲染会使用制作资源，带解说的视频可能用到语音生成。设定定时任务前，先用一条允许制作的记录试跑。

在「设置 → API 密钥」里显示并复制密钥，保存到 n8n 的凭据里。别贴进 AI 对话、导出的流程、表格或浏览器代码。当前每个账号提供一把个人密钥，不按自动化分别发放。

1. 先发一个只读请求

在 n8n 创建通用 Bearer Auth 凭据，填入工作台密钥。用它配置第一个 HTTP Request：

示例

Method: GET
URL: https://api.bsquarerealty.com/v1/workflow-api/media/templates
Authentication: Generic Credential Type → Bearer Auth
Query parameters:
  medium = poster
  limit = 20

从返回结果里取真实的 templateId。如果有 nextCursor，用它作为 cursor 继续读下一页。视频模板用 medium=video。选定后读取模板：

示例

GET https://api.bsquarerealty.com/v1/workflow-api/media/templates/TEMPLATE_ID?medium=poster

按返回的 body.inputSchema 组装输入。各模板不共用固定的 address、price 或 photos 字段。也可以请已连接的助手帮你整理映射：

示例

Read AgentOS template [TEMPLATE ID] for [poster/video]. Return its required input fields and a complete generation request using only these approved facts and assets: [FACTS AND ASSET REFERENCES]. Use the template's real input names. Mark missing required values instead of inventing them. Do not generate anything. Do not include credentials.

2. 把提交所需的信息记下来

为每个任务保存源记录 ID、媒体类型、模板 ID、完整输入和 requestKey。新成品用新键。恢复同一次提交时，复用原键和原请求体。

请求键长 8–160 个字符，例如 campaign-SOURCE_ID-poster-v1。这是你自己选的命名方式。

3. 提交制作

用同一凭据添加 POST HTTP Request，设 Content-Type: application/json。发送前换成真实模板 ID，并按模板填完整输入：

              JSON
            
{
  "action": "start",
  "medium": "poster",
  "templateId": "TEMPLATE_ID",
  "inputs": {},
  "requestKey": "campaign-SOURCE_ID-poster-v1"
}

提交地址：

示例

POST https://api.bsquarerealty.com/v1/workflow-api/media/generate

做视频时用 medium: "video"，配视频模板和它要求的输入，可选 outputFormat: "mp4"。把海报模板的媒体类型改成视频，并不能转换模板。

带解说的视频先准备并审核解说词与选图顺序。可选的 /media/narration-review 接收 templateId 和 inputs，只校验声明的分镜，不生成视频或补写解说。当前密钥接口不提供单独的 AI 解说起草工具。

4. 等任务完成

HTTP 202 表示已受理。立即保存 operation.operationId，它不是模板 ID，也不是视频 workId。加一个 Wait 节点，再用相同的媒体类型查询：

示例

https://api.bsquarerealty.com/v1/workflow-api/media/operations/OPERATION_ID?medium=poster

看 operation.status。处于 queued 或 running 时，稍后再查原任务。到了 succeeded，从 operation.artifacts 里选海报图片或 MP4，避开缩略图和字幕。遇到 failed 或 canceled，停止并记录错误。状态为 unknown 时先核对原任务，别自动再提交。

有 nextPollAfterMs 就按它等待；没有可以先用 15 秒间隔，设置总等待上限，并保留任务 ID 方便续查。轮询只读状态。

5. 检查成品，再交给下一步

把任务 ID 和选中的成品信息存回源记录。发布前检查文字、照片顺序、画面尺寸和声音。成品链接可能有 expiresAt，保留任务引用，之后可重新取授权链接。

下一步用 Buffer 时，把已批准的文件放到有权使用的存储，取得稳定的公开媒体地址再排期。

频率限制和恢复

当前密钥接口对海报、视频和工作流运行共用每分钟 5 次、每 24 小时 100 次提交上限。读取和审核共用每分钟 60 次。收到 429 时遵守 Retry-After。POST 后网络报错，可能已经受理，恢复时保留原键和请求体。

密钥接口可读模板、生成成片、读任务和运行已发布的自定义工作流。编辑模板、上传素材、任意搜索 MLS 和发布工作流要在工作台或使用相应的授权 MCP 工具。

2026 年 11 月 9 日对照源码核对了路由和请求格式。编写指南时没有查看密钥、付费渲染或运行 n8n 流程。启用定时前，在自己的环境先试一次读取和一项已批准的制作。