在 CI 里自动生成视频素材：GitHub Actions 调用 Seedance API

在 GitHub Actions 中调用 Seedance API 生成视频素材，只需三步：将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，在 workflow 里通过 POST /v1/video/generations 提交任务并轮询状态，再把生成的 video url 作为构建产物保存。RelayDance 采用 OpenAI 兼容协议，按秒计费(Seedance 2.0 720p 约 $0.190 / 秒)，失败请求不计费，适合自动化流水线接入。详见 relaydance.com/docs。

如何在 workflow 中配置认证与 base_url

在 GitHub Actions 中接入的关键，是保留 OpenAI SDK 并替换 base_url 与 API Key。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此无需引入额外依赖。请在仓库 Settings 中将 API Key 存为加密的 Secret，在 workflow 里以 Authorization: Bearer YOUR_API_KEY 形式读取，密钥可在 https://relaydance.com/console 创建。接入无需 BytePlus 企业账号或 KYC，付款支持 USDT 与 Stripe card，方便团队在 CI 环境中集中管理凭据与配额。

提交与轮询视频任务的步骤

在 CI 里生成视频分为提交任务与轮询结果两个阶段。参考以下步骤：

1. 调用 POST /v1/video/generations，传入 model、prompt、seconds 以及 metadata (ratio、resolution、generate_audio)。
2. 在 metadata.content[] 中放入参考媒体，单次请求最多 9 张参考图、3 段参考视频、3 条音频，片段长度上限 15 秒，并在 prompt 中以 @image1 到 @imageN 引用。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，从结果中取出 video url。
4. 将 video url 下载并作为 Actions 构建产物(artifact)上传保存。

若不想轮询，可设置 metadata.callback_url 使用 Webhook 模式，最终状态会 POST 到你的服务器。

各模型价格与在 CI 中的计费

不同 Seedance 档位的按秒或按条价格决定了流水线成本，具体如下表。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此在 CI 中因超时或参数错误导致的失败任务不会产生费用。计费为 pay-as-you-go，按实际生成的视频结算。实时费率请以 relaydance.com/models 为准。

如何配套生成图像素材

视频流水线常需配套封面或参考图，可用同一账号调用图像接口。图像生成使用 POST /v1/images/generations，其中 gpt-image-2 的计费方式为图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价(来源 relaydance.com/models)。这意味着在 CI 中先用 gpt-image-2 产出参考图，再将其作为 metadata.content[] 传入视频任务，可构建一条从图到视频的自动化链路，所有请求共用 https://relaydance.com/v1 与同一 Bearer 密钥。

FAQ

问：CI 任务失败会被扣费吗？

答：不会。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，计费按实际生成的视频结算。

问：单次请求可以传多少参考媒体？

答：单次请求最多 9 张参考图、3 段参考视频、3 条音频，片段长度上限 15 秒，在 prompt 中以 @image1 到 @imageN 引用。

问：接入是否需要 BytePlus 企业账号或 KYC？

答：不需要。RelayDance 提供 OpenAI 兼容的直接访问，只需在 https://relaydance.com/console 创建密钥，付款支持 USDT 与 Stripe card。