Telegram 机器人接入视频生成：RelayDance API 异步任务处理

在 Telegram 机器人中接入视频生成，可通过 RelayDance 的 OpenAI 兼容接口完成：将 base_url 改为 https://relaydance.com/v1，用 POST /v1/video/generations 提交任务并返回 task_id，再由机器人轮询 GET /v1/video/generations/{task_id} 或设置 metadata.callback_url 接收 Webhook 回调，任务状态为 succeeded 时把结果中的视频 url 回传给用户，失败或报错的请求一律不计费。

如何将 RelayDance 接入 Telegram 机器人

接入方式是复用现有 OpenAI SDK 并替换 base_url，无需重写请求逻辑。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此 Telegram 机器人只需在初始化 SDK 时指定新的 base_url，并在请求头加入 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。可调用模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 与 Grok 系列。更多接口说明见 https://relaydance.com/docs，实时费率见 https://relaydance.com/models。

异步任务处理：轮询与 Webhook 两种模式

视频生成为异步任务，Telegram 机器人可选择轮询或 Webhook 两种方式获取结果。提交任务后返回 task_id，轮询模式下机器人定时请求 GET /v1/video/generations/{task_id}，直到状态变为 succeeded 或 failed，结果中包含视频 url。Webhook 模式下设置 metadata.callback_url，任务最终状态会 POST 到你的服务器，适合避免长时间轮询占用机器人进程。参考媒体放入 metadata.content[]，在 prompt 中以 @image1 到 @imageN 引用，单次请求支持最多 9 张参考图、3 段参考视频与 3 条音轨，片段长度可达 15 秒。

提交视频任务的步骤

在 Telegram 机器人中提交一次视频任务可按以下步骤完成：

1. 在 https://relaydance.com/console 创建 API Key，并把 base_url 设为 https://relaydance.com/v1。
2. 向 POST /v1/video/generations 发送请求，携带 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
3. 如需参考媒体，放入 metadata.content[] 并在 prompt 中用 @image1 到 @imageN 引用。
4. 轮询 GET /v1/video/generations/{task_id}，或等待 metadata.callback_url 回调。
5. 状态为 succeeded 时，将结果中的视频 url 通过 Telegram 消息回传给用户。

各模型价格与计费对比

RelayDance 采用按生成量付费（pay-as-you-go），下表列出主要模型的参考单价，实时费率以 https://relaydance.com/models 为准。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此机器人在重试失败任务时不会产生额外费用。

付款方式支持 USDT 与 Stripe 银行卡，接入 Seedance 无需 BytePlus 企业账户或 KYC。

常见问题（FAQ）

问：任务失败会扣费吗？不会，失败或报错的请求一律不计费。

问：Telegram 机器人如何知道视频生成完成？可轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded，或设置 metadata.callback_url 由服务器接收最终状态的 POST 回调。

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