把 Seedance 封装成 function calling 工具：让 LLM Agent 自己生成视频

把 Seedance 封装成 function calling 工具，就是在 Agent 的工具定义里注册一个视频生成函数，函数体内部通过 OpenAI 兼容协议调用 RelayDance 的 POST /v1/video/generations 接口。你只需把 base_url 改为 https://relaydance.com/v1，让 LLM 输出 prompt、seconds 等参数并交由函数执行，随后轮询任务状态即可让 Agent 自主完成视频生成。计费按生成的视频按量结算，失败请求不计费。

为什么可以直接封装：OpenAI 兼容协议

可以直接封装的原因是 RelayDance 采用 OpenAI 兼容协议，无需为工具单独适配私有 SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，这意味着你在现有 Agent 框架里注册工具时，可复用已有的 OpenAI 客户端。鉴权使用 Authorization: Bearer YOUR_API_KEY，密钥在 https://relaydance.com/console 创建。视频任务通过 POST /v1/video/generations 提交，图像任务走 POST /v1/images/generations，无需 BytePlus 企业账号或 KYC，降低了工具接入门槛。详情见 https://relaydance.com/docs。

把生成视频定义为一个 function

封装的核心是把 POST /v1/video/generations 抽象成一个可被 LLM 调用的函数，参数从 prompt 到 seconds 均由模型填充。请求体包含 model、prompt、seconds，以及 metadata 中的 ratio、resolution、generate_audio 与 callback_url。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。每次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，单个片段时长最长 15 秒。函数返回 task_id，Agent 据此进入下一步轮询或等待回调。

让 Agent 自主执行：轮询或 Webhook

Agent 自主执行的方式有两种：主动轮询任务状态，或配置回调让服务端接收最终结果。轮询模式下调用 GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed，成功后结果中包含视频 url。Webhook 模式下在 metadata.callback_url 设置回调地址，最终状态会被 POST 到你的服务器。步骤如下：

1. LLM 通过 function calling 输出参数并调用工具。
2. 工具向 POST /v1/video/generations 提交任务，取得 task_id。
3. 轮询 GET /v1/video/generations/{task_id} 或等待 callback_url 回调。
4. 状态为 succeeded 后把视频 url 返回给 Agent。

成本与计费：把价格暴露给 Agent 做决策

把各档价格作为工具描述的一部分暴露给 Agent，可帮助模型在分辨率与成本间做出取舍。按 relaydance.com/models 的实时费率，Seedance 2.0 720p 约 $0.190 / 秒，Seedance 2.0 1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。计费为按量付费，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，这对需要重试的 Agent 流程尤为重要。支付方式支持 USDT 与 Stripe 卡。

常见问题 FAQ

问：封装工具需要改动现有 OpenAI 客户端吗？不需要重写客户端，只需把 base_url 改为 https://relaydance.com/v1，并使用 Authorization: Bearer YOUR_API_KEY 鉴权。

问：Agent 重试失败任务会重复扣费吗？不会，失败或报错的请求一律不计费，计费仅针对成功生成的视频按量结算。

问：一次请求能带多少参考媒体？每次请求最多 9 张参考图、3 段参考视频与 3 条音轨，媒体放入 metadata.content[] 并在 prompt 中以 @image1 到 @imageN 引用，单片段最长 15 秒。