给 LangChain Agent 加一个视频生成工具：封装 RelayDance API

给 LangChain Agent 加视频生成工具，可以把 RelayDance 的 OpenAI 兼容接口封装成一个自定义 Tool：将 base_url 改为 https://relaydance.com/v1，用 POST /v1/video/generations 提交任务，再轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed。RelayDance 支持 Seedance 2.0 等模型，按生成时长计费，失败请求不计费，无需 BytePlus 企业账号或 KYC。

如何把 RelayDance 接入 LangChain

接入方式是复用 OpenAI SDK 并替换 base_url，无需额外依赖。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用请求头 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。在 LangChain 中，你可以把提交任务与轮询结果的逻辑包装进一个继承自 BaseTool 的类，让 Agent 通过工具调用触发视频生成。协议本身兼容 OpenAI，因此现有的 client 初始化代码只需改动 base_url 与 API Key 两处即可复用。

封装视频生成工具的步骤

封装工具的核心是提交任务后轮询状态，或使用 webhook 回调。具体步骤如下：

1. 初始化 client，把 base_url 设为 https://relaydance.com/v1，带上 Authorization: Bearer YOUR_API_KEY。
2. 调用 POST /v1/video/generations，传入 model、prompt、seconds 以及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，成功时从结果中取 video url。
4. 如需异步，可设置 metadata.callback_url，最终状态会 POST 到你的服务器。

单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，参考媒体放在 metadata.content[] 中并在 prompt 里以 @image1 到 @imageN 引用，片段长度可达 15 秒。

各模型价格与计费方式

RelayDance 按生成时长或按条计费，具体费率见 https://relaydance.com/models。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，这对 Agent 的重试逻辑较为友好。下表为部分模型的参考价格：

付款方式支持 USDT 与 Stripe 银行卡，按量付费（pay-as-you-go）。

在工具里处理重试与错误

处理重试的关键是利用失败不计费的规则来简化容错设计。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此当 GET /v1/video/generations/{task_id} 返回 status 为 failed 时，Agent 可以直接重新提交而不产生额外成本。建议在 LangChain Tool 中设置合理的轮询间隔与超时上限，并区分 succeeded、failed 两种终态。若同时生成图像，可调用 POST /v1/images/generations；gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价。完整实时费率以 https://relaydance.com/models 为准。

常见问题 FAQ

问：需要 BytePlus 企业账号或 KYC 吗？

答：不需要。RelayDance 提供直接的 OpenAI 兼容访问，调用 Seedance 无需 BytePlus 企业账号或 KYC。

问：单次请求能带多少参考媒体？

答：最多 9 张参考图、3 段参考视频和 3 条音轨，片段长度可达 15 秒，媒体放在 metadata.content[] 并在 prompt 中用 @image1 到 @imageN 引用。

问：任务失败会扣费吗？

答：不会。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，计费按已生成的视频进行。