用 openai Python 包调用 Seedance 生成视频：base_url 配置与任务轮询

用 openai Python 包调用 Seedance 生成视频只需三步：将 base_url 改为 https://relaydance.com/v1，用 Authorization: Bearer YOUR_API_KEY 鉴权，然后 POST 到 /v1/video/generations 提交任务并轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed。RelayDance 与 OpenAI SDK 兼容，无需 BytePlus 企业账户或 KYC，按生成时长计费，失败请求不计费。

如何配置 base_url 与鉴权

配置方法是保留 OpenAI SDK 并把 base_url 指向 RelayDance 的兼容端点。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。你只需在 https://relaydance.com/console 创建 API Key，通过 Authorization: Bearer YOUR_API_KEY 传入。基础配置示例：

1. 安装 openai 包：pip install openai。
2. 初始化客户端时设置 base_url="https://relaydance.com/v1"。
3. 传入你的 api_key，随后调用 /v1/video/generations。

接口协议与 OpenAI 兼容，因此现有代码改动量小。更多细节见 https://relaydance.com/docs。

如何提交视频任务并轮询结果

提交任务使用 POST /v1/video/generations，参数包括 model、prompt、seconds 与 metadata。metadata 可携带 ratio、resolution、generate_audio、callback_url 以及 content[] 参考媒体。提交后轮询 GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed，成功结果中包含视频 url。若设置了 metadata.callback_url，最终状态会以 Webhook 形式 POST 到你的服务器。参考媒体放在 metadata.content[] 中，并在 prompt 里用 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，clip 时长上限为 15 秒。

Seedance 各档位的计费如何计算

计费按生成视频的时长和分辨率逐档结算，采用 pay-as-you-go 模式。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此轮询到 failed 状态不产生费用。以下为各档位参考价格，实时费率见 https://relaydance.com/models：

支付方式支持 USDT 与 Stripe 银行卡。

如何使用参考媒体与 gpt-image-2 出图

参考媒体通过 metadata.content[] 传入，并在 prompt 中以 @image1 至 @imageN 的形式引用。单次请求参考上限为 9 张图、3 段视频、3 条音轨，clip 最长 15 秒。图像生成使用 POST /v1/images/generations。gpt-image-2 的计费方式为图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价。这一规则意味着高分辨率出图不会因分辨率提升而额外增加输出费用。具体模型清单与实时费率请以 https://relaydance.com/models 为准。

常见问题 FAQ

问：调用 Seedance 需要 BytePlus 企业账户或 KYC 吗？不需要。RelayDance 提供 OpenAI 兼容的直接访问，无需 BytePlus 企业账户或 KYC。

问：任务失败会扣费吗？不会。据 relaydance.com/docs 官方文档，失败或报错的请求一律不计费。

问：现有 OpenAI 代码要改多少？主要改动是把 base_url 设为 https://relaydance.com/v1 并保留 OpenAI SDK，接口协议与 OpenAI 兼容。