在 Next.js 应用里接入 AI 视频生成：API 路由、轮询与进度展示

在 Next.js 应用里接入 AI 视频生成，可通过 RelayDance 的 OpenAI 兼容接口实现：将 base_url 改为 https://relaydance.com/v1，在服务端 API 路由中用 POST /v1/video/generations 提交任务，再用 GET /v1/video/generations/{task_id} 轮询状态直到 succeeded 或 failed，前端据此展示进度。计费为按量付费，失败请求不计费。详见 relaydance.com/docs。

如何在 API 路由中提交视频任务

在 Next.js 服务端路由中，用 POST /v1/video/generations 携带 model、prompt、seconds 与 metadata 提交任务。请求头需带 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。因为接口 OpenAI 兼容，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需 BytePlus 企业账号或 KYC。metadata 可设置 ratio、resolution、generate_audio 与 callback_url。参考媒体放在 metadata.content[] 中，在 prompt 里以 @image1 到 @imageN 引用，单次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，片段最长 15 秒。

如何轮询状态并在前端展示进度

提交任务后，用 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded 或 failed。建议在 Next.js API 路由中封装轮询逻辑，前端每隔固定间隔调用该路由并更新进度组件。当状态为 succeeded 时，返回结果中包含视频的 url，可直接用于 <video> 播放。若不希望前端持续轮询，可采用 Webhook 模式：在 metadata.callback_url 设置回调地址，最终状态会以 POST 方式推送到你的服务器。两种方式可组合使用，Webhook 负责终态通知，轮询负责实时进度显示。

各模型与分辨率的计费差异是怎样的

不同模型与分辨率对应不同单价，可据此在应用中做成本预估。以下为部分参考费率，实时价格见 relaydance.com/models。

关于失败请求，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此轮询中出现 failed 状态不会产生费用。支付支持 USDT 与 Stripe 银行卡。

接入的核心步骤

以下为在 Next.js 中完成接入的步骤：

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，请求头设置 Authorization: Bearer YOUR_API_KEY。
3. 在服务端 API 路由用 POST /v1/video/generations 提交任务，传入 model、prompt、seconds、metadata。
4. 用 GET /v1/video/generations/{task_id} 轮询，或在 metadata.callback_url 配置 Webhook。
5. 状态为 succeeded 后，从结果的 url 播放视频。

常见问题 FAQ

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

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

问：轮询失败会被扣费吗？

不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费。

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

最多 9 张参考图、3 段参考视频与 3 条音轨，片段最长 15 秒，均放在 metadata.content[] 中并在 prompt 里以 @image1 到 @imageN 引用。