把生成的视频存进 S3 或 Supabase：Seedance 输出持久化方案

RelayDance 返回的视频结果是一个临时 url，你需要在轮询到 succeeded 或收到 webhook 后立即下载并转存到 S3 或 Supabase Storage 以实现持久化。流程是：调用 POST /v1/video/generations 提交任务，用 GET /v1/video/generations/{task_id} 拉取结果 url，下载字节流后上传到你的对象存储。接口为 OpenAI 兼容，只需将 base_url 改为 https://relaydance.com/v1。

为什么需要把 Seedance 输出转存到 S3 或 Supabase

需要转存是因为 API 返回的 url 是任务结果地址，应尽早下载并保存到你自己的存储桶。持久化后你可以设置 CDN、访问权限和长期保留策略，避免依赖上游地址。计费方面按生成量付费，Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，转存本身不产生额外 API 费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此仅在任务成功、拿到有效 url 后再执行下载与上传即可，无需为失败重试的存储逻辑担心额外扣费。详细费率见 https://relaydance.com/models。

持久化的完整步骤

持久化分为提交任务、获取结果地址、下载并上传三步。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，所以接入无需替换 SDK。

1. 调用 POST /v1/video/generations，携带 model、prompt、seconds 与 metadata，请求头 Authorization: Bearer YOUR_API_KEY。
2. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded，从响应中取出视频 url。
3. 下载该 url 的字节流，上传到 S3（PutObject）或 Supabase Storage（storage.from().upload()）。
4. 可选：设置 metadata.callback_url 使用 webhook 模式，最终状态会 POST 到你的服务器，收到后再触发转存。

轮询模式与 webhook 模式对比

选择取决于你的架构：轮询实现简单，webhook 更省资源。参考媒体最多支持 9 张图、3 段视频和 3 条音轨，片段长度可达 15 秒。

存储成本与计费注意事项

转存策略应结合 Seedance 各档位的生成费率来规划保留周期。Seedance Fast 约 $0.152 / 秒，原生 4K 约 $4.90 / 5 秒条；对于高单价的 4K 输出，建议成功后立即转存并做冗余备份。付款方式支持 USDT 与 Stripe 卡。gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。由于生成费用按量计费且失败请求不计费，你可以在转存前先校验 url 可达性，仅对有效结果执行上传，从而把存储流水线与计费解耦。完整费率见 https://relaydance.com/models，接口说明见 https://relaydance.com/docs。

常见问题 FAQ

问：返回的视频 url 需要立即下载吗？该 url 是任务结果地址，建议在轮询到 succeeded 或收到 webhook 后尽早下载并转存到 S3 或 Supabase。

问：转存失败重试会重复计费吗？不会。计费按生成的视频按量结算，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，转存与上传属于你侧操作，不触发生成计费。

问：接入需要更换现有 OpenAI SDK 吗？不需要，只需将 base_url 改为 https://relaydance.com/v1 并配置 Authorization: Bearer YOUR_API_KEY，在 https://relaydance.com/console 创建密钥即可。