在 Cloudflare Workers 里调用 Seedance API：边缘环境处理长耗时任务

在 Cloudflare Workers 中调用 Seedance API，需将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，用 POST /v1/video/generations 提交任务，再通过轮询 GET /v1/video/generations/{task_id} 或设置 metadata.callback_url 的 Webhook 获取结果。由于 Workers 单次请求执行时间有限，长耗时视频任务应采用异步提交加回调的方式，避免在边缘函数内长时间等待。据 relaydance.com 官方文档，失败或报错的请求一律不计费。

为什么边缘环境适合 Seedance 的异步任务

Cloudflare Workers 适合作为提交与回调的中转层，而非长时间阻塞等待的执行环境。视频生成属于长耗时任务，单个 clip 最长可达 15 秒，同步等待会超出 Workers 的执行时限。因此推荐在 Worker 中仅完成任务提交（POST /v1/video/generations），并设置 metadata.callback_url，让最终状态由 RelayDance 主动 POST 回你的服务器。接口协议为 OpenAI 兼容，据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，迁移成本较低。详细计费见 relaydance.com/models。

提交任务与获取结果的两种模式

在 Workers 中可选择轮询或 Webhook 两种模式获取视频结果。轮询模式下，提交任务后周期性调用 GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed，结果中包含视频 url。Webhook 模式下，设置 metadata.callback_url，最终状态会被 POST 到你的服务器，更适合边缘环境的短生命周期。参考媒体放入 metadata.content[]，在 prompt 中以 @image1 到 @imageN 引用，单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨。认证通过 Authorization: Bearer YOUR_API_KEY，密钥在 relaydance.com/docs 对应的控制台创建。

Seedance 各档位价格对照

不同分辨率与模式的 Seedance 计费按秒或按条计算，可据此在 Workers 中选择合适档位。以下为各档位参考价格：

此外，gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。计费为按量付费，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，实时费率以 relaydance.com/models 为准。

在 Workers 中调用的实现步骤

在 Cloudflare Workers 中集成 Seedance，可按以下步骤操作：

1. 在控制台创建 API Key，并作为环境变量注入 Worker。
2. 将 OpenAI SDK 的 base_url 设为 https://relaydance.com/v1，请求头带上 Authorization: Bearer YOUR_API_KEY。
3. 用 POST /v1/video/generations 提交任务，携带 model、prompt、seconds，并在 metadata 中设置 ratio、resolution、generate_audio。
4. 设置 metadata.callback_url 指向你的接收端点，避免在 Worker 内长时间等待。
5. 接收 Webhook POST 的最终状态，或用 GET /v1/video/generations/{task_id} 轮询，读取结果中的视频 url。

支付方式支持 USDT 与 Stripe 卡（Stripe card），无需 BytePlus 企业账户或 KYC。

常见问题 FAQ

问：在 Workers 里长耗时任务会因超时导致重复计费吗？据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，采用 Webhook 异步模式可以规避 Worker 执行时限带来的中断。

问：单次请求能放多少参考媒体？最多 9 张参考图、3 段参考视频和 3 条音轨，单个 clip 最长 15 秒，参考媒体放在 metadata.content[]，在 prompt 中以 @image1 到 @imageN 引用。

问：现有 OpenAI 代码需要大改吗？不需要，据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，保留原有 SDK 即可。