用 AI 视频 API 做游戏过场预演和概念动画

游戏团队可以通过 RelayDance 的 OpenAI 兼容视频 API，将文字描述或角色概念图直接生成过场动画和概念动效，无需采购专业合成软件或申请 BytePlus 企业账户。调用入口为 https://relaydance.com/v1，支持 Seedance 系列视频模型，按生成时长按需计费，失败请求不收费，适合游戏原型阶段的快速迭代与动画预演。

接入方式：保留 OpenAI SDK，只改一行配置

切换到 RelayDance 只需修改 base_url，不需要替换已有的 OpenAI SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。以 Python 为例，初始化时传入 base_url="https://relaydance.com/v1" 和 api_key="YOUR_API_KEY" 即可，其余调用代码无需改动。API Key 在 relaydance.com/console 创建，充值支持 USDT 和 Stripe 信用卡，无订阅门槛，无 KYC 要求。鉴权方式为标准 HTTP 头部 Authorization: Bearer YOUR_API_KEY。

视频生成工作流

生成一段游戏过场预演视频，完整流程分为任务提交、状态轮询和结果获取三个步骤。

1. 提交任务：向 POST /v1/video/generations 发送请求，必填参数为 model、prompt、seconds，metadata 对象中可设置 ratio、resolution、generate_audio 及 callback_url。若需传入概念图或参考视频，将媒体文件放入 metadata.content[]，并在 prompt 中以 @image1 至 @imageN 的形式引用，单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，单段素材最长 15 秒。
2. 轮询状态：调用 GET /v1/video/generations/{task_id}，直到 status 字段返回 succeeded 或 failed。
3. 获取结果：状态为 succeeded 时，响应体中包含可直接下载的视频 URL。
4. Webhook 模式（可选）：在 metadata.callback_url 中填写服务器地址，任务完成后系统会主动推送最终状态，无需持续轮询。

各档位模型与定价对比

针对不同画质和预算要求，RelayDance 提供从约 $0.152 / 秒到 $4.90 / 5 秒条的多个 Seedance 档位，实时价格见 relaydance.com/models。

图像生成使用 POST /v1/images/generations 接口，支持 gpt-image-2 模型。该模型图像输出免费，仅按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价，可用于游戏概念图的快速生成。

计费规则与调试期成本控制

RelayDance 采用按实际生成时长的按需付费模式，调试阶段无需担心失败请求产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。这意味着在原型阶段频繁调整 prompt、分辨率或参考媒体参数时，只有成功生成的视频才会计入账单。账户余额不足或网络超时等原因导致的任务失败，同样不会扣费。当前各模型的精确单价会随供需情况调整，建议在 relaydance.com/models 查看实时费率再估算项目成本。

常见问题

Q: 使用 RelayDance 的 Seedance 模型，是否需要申请 BytePlus 企业账户或完成 KYC 认证？

不需要。RelayDance 提供直接的 OpenAI 兼容接入，在 relaydance.com/console 注册、充值后即可调用，无需企业资质或身份认证流程。

Q: 视频任务生成失败后会扣费吗？

不会。官方明确说明失败或报错的请求一律不计费，游戏团队在原型和调试阶段可以放心反复测试参数，不必担心因接口报错产生额外支出。

Q: 单段生成的过场动画最长可以是多少秒？能否传入已有的角色原画作为参考？

单段视频最长支持 15 秒。可以传入参考图，将原画放入 metadata.content[] 并在 prompt 中以 @image1 等标记引用，单次请求最多支持 9 张参考图。如需更长的过场动画，可将多段结果拼接处理。