用 Streamlit 给团队搭内部视频工具：Seedance API 前端实践

用 Streamlit 搭建 Seedance 内部视频工具的核心是：调用 RelayDance 的 OpenAI 兼容接口，将 base_url 改为 https://relaydance.com/v1，通过 POST /v1/video/generations 提交任务并轮询 GET /v1/video/generations/{task_id} 获取视频 url。前端只需三个控件：提示词输入、参数选择和结果展示。Seedance 2.0 720p 约 $0.190/秒，失败请求不计费，适合团队内部按需生成。

为什么选择 OpenAI 兼容接口接入 Streamlit

OpenAI 兼容协议让你复用现有 SDK，无需重写请求逻辑。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。这意味着在 Streamlit 应用中，你只需在初始化客户端时修改 base_url 和填入 Authorization: Bearer YOUR_API_KEY，即可提交视频任务。API Key 在 https://relaydance.com/console 创建。接入不要求 BytePlus 企业账户或 KYC，减少了团队内部工具的部署门槛。参考媒体放入 metadata.content[]，在提示词中以 @image1 到 @imageN 引用，单次请求支持最多 9 张参考图、3 段参考视频和 3 条音轨。

Streamlit 前端的提交与轮询流程

Streamlit 应用的主循环是：提交任务，然后轮询状态直到成功或失败。以下是内部工具的最小实现步骤：

1. 初始化 OpenAI 客户端，base_url 设为 https://relaydance.com/v1。
2. 用 st.text_area 收集 prompt，用 st.selectbox 选择 model、resolution 与 seconds。
3. 调用 POST /v1/video/generations，传入 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio）。
4. 用 st.spinner 包裹轮询，定时请求 GET /v1/video/generations/{task_id}。
5. 当 status 为 succeeded 时，用 st.video 播放结果中的视频 url；为 failed 时提示重试。

单个片段最长可生成 15 秒。生产环境也可改用 webhook 模式，设置 metadata.callback_url，最终状态会 POST 到你的服务器。

团队使用的成本预估与计费说明

团队内部工具的成本可按秒或按条精确预估。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此调试阶段的报错不会产生费用。计费为按生成量付费（pay-as-you-go），支持 USDT 与 Stripe 卡支付。以下为参考费率（实时费率见 https://relaydance.com/models）：

若前端同时集成 gpt-image-2 出图，图像输出免费，只按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价。

在前端暴露哪些参数给团队成员

建议只暴露 model、prompt、seconds、resolution 与 generate_audio 这几个参数，降低误操作风险。resolution 控件可对应 720p 与 1080p 两档，直接影响成本（$0.190/秒 与 $0.470/秒）。对需要图像的场景，可增加 POST /v1/images/generations 的调用入口。参考媒体上传后写入 metadata.content[]，并在 prompt 文本中以 @image1 引用，前端应校验上传数量不超过 9 张图。轮询与 webhook 两种回调方式可根据团队规模选择：小团队用轮询即可，高并发场景建议配置 callback_url 由服务器接收最终状态。

常见问题

问：调试时报错会扣费吗？不会。失败或报错的请求一律不计费，可放心在 Streamlit 中反复测试参数组合。

问：需要 BytePlus 企业账户或 KYC 吗？不需要。通过 OpenAI 兼容接口直接访问 Seedance，无需企业账户或 KYC。

问：单次请求能放多少参考素材？最多 9 张参考图、3 段参考视频和 3 条音轨，单个片段最长 15 秒，在 prompt 中以 @image1 到 @imageN 引用。