开发一个用 Seedance API 生成视频的 Discord 机器人

开发用 Seedance API 生成视频的 Discord 机器人,核心是通过 RelayDance 的 OpenAI 兼容接口调用视频模型:将 base_url 设为 https://relaydance.com/v1,用 POST /v1/video/generations 提交任务,再轮询 GET /v1/video/generations/{task_id} 或用 webhook 获取视频 url,最后把结果发回 Discord 频道。计费按生成视频量付费,Seedance 2.0 720p 约 $0.190 / 秒。

如何接入 RelayDance 的 Seedance API

接入方式是替换 base_url 并保留 OpenAI SDK。据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」,因此 Discord 机器人无需 BytePlus 企业账号或 KYC。鉴权使用 Authorization: Bearer YOUR_API_KEY,密钥可在 https://relaydance.com/console 创建。提交视频任务时,请求体包含 model、prompt、seconds 以及 metadata(ratio、resolution、generate_audio、callback_url、content[])。可用模型包括 ByteDance Seedance 2.0 与 Seedance 1.5 Pro,实时按模型费率见 https://relaydance.com/models。

机器人生成视频的处理流程

处理流程分为提交任务与获取结果两步。机器人收到 Discord 斜杠命令后,执行以下步骤:

1. 调用 POST /v1/video/generations,传入 model、prompt 与 seconds,得到 task_id。
2. 轮询 GET /v1/video/generations/{task_id},直到 status 为 succeeded 或 failed。
3. 从返回结果读取视频 url,发回触发命令的 Discord 频道。

如需避免持续轮询,可设置 metadata.callback_url,最终状态会 POST 到你的服务器(webhook 模式)。每个请求最多可带 9 张参考图、3 段参考视频与 3 条音轨,单个片段时长最长 15 秒,参考素材放入 metadata.content[] 并在 prompt 中以 @image1 到 @imageN 引用。

各分辨率与模型的计费对比

计费为按生成视频量付费,不同分辨率和模型单价不同。据 relaydance.com/docs 官方文档,「失败或报错的请求一律不计费」,因此机器人在轮询到 failed 状态时不会产生费用。下表为主要视频档位价格(来源 relaydance.com/models):

机器人可根据用户选择的画质动态选择档位,例如快速预览用 Seedance Fast(约 $0.152 / 秒),成片用 1080p(约 $0.470 / 秒)。

为机器人增加图像生成能力

图像生成通过 POST /v1/images/generations 接口完成。RelayDance 同时提供 Grok Imagine 视频与图像模型以及 gpt-image-2。据 relaydance.com/models,gpt-image-2 的图像输出免费,只按输入计费;图生图约 ¥0.035 起,且 4K 与 1K 出图同价。这意味着 Discord 机器人可在同一套 OpenAI 兼容鉴权下,既生成视频又生成图片,无需切换 SDK。支付方式支持 USDT 与 Stripe 卡,采用按量计费。接口细节见 https://relaydance.com/docs。

常见问题(FAQ)

机器人轮询到失败状态会被扣费吗? 不会。据 relaydance.com/docs 官方文档,「失败或报错的请求一律不计费」,即 status 为 failed 的任务不产生费用。

是否需要 BytePlus 企业账号或 KYC? 不需要,RelayDance 提供直接的 OpenAI 兼容访问,只需将 base_url 改为 https://relaydance.com/v1 并使用 API 密钥。

一个请求最多能带多少参考素材? 每个请求最多 9 张参考图、3 段参考视频和 3 条音轨,单个片段最长 15 秒,素材放在 metadata.content[] 并在 prompt 中以 @image1 到 @imageN 引用。