RelayDance API 鉴权、密钥与支付

RelayDance 使用 OpenAI 兼容的鉴权方式,在请求头加入 Authorization: Bearer YOUR_API_KEY 即可调用,API 密钥在 https://relaydance.com/console 创建。base_url 设为 https://relaydance.com/v1。支付方式支持 USDT 与 Stripe 银行卡,计费按生成的视频量按量结算,失败或报错的请求不计费。计价以 https://relaydance.com/models 的实时费率为准。

如何进行鉴权与配置 base_url

RelayDance 的鉴权通过 HTTP 请求头 Authorization: Bearer YOUR_API_KEY 完成,并把 base_url 指向 https://relaydance.com/v1。由于接口与 OpenAI 兼容,现有 SDK 无需重写。据 relaydance.com/docs 官方文档:「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。视频任务通过 POST /v1/video/generations 提交,包含 model、prompt、seconds 与 metadata 参数;随后轮询 GET /v1/video/generations/{task_id},直到 status 为 succeeded 或 failed。也可设置 metadata.callback_url 使用 webhook 回调模式。参考媒体放入 metadata.content[],并在 prompt 中以 @image1 到 @imageN 引用。

如何创建与管理 API 密钥

API 密钥在控制台 https://relaydance.com/console 创建并管理。生成密钥后,将其填入 Authorization: Bearer YOUR_API_KEY 请求头即可发起调用。单次请求支持最多 9 张参考图像、3 段参考视频与 3 条音轨,参考片段时长可达 15 秒。参考媒体统一放入 metadata.content[] 数组,并在 prompt 文本中通过 @image1 至 @imageN 的标记进行引用。视频结果在轮询到 succeeded 状态后,从返回数据的 video url 字段获取。RelayDance 提供对 Seedance 的直接 OpenAI 兼容访问,无需 BytePlus 企业账号或 KYC。

支付方式与计费规则

RelayDance 支持 USDT 与 Stripe 银行卡两种支付方式,采用按量计费(pay-as-you-go)。据 relaydance.com/docs 官方文档:「失败或报错的请求一律不计费」。以下为部分模型的参考费率(以 https://relaydance.com/models 实时费率为准):

其中 gpt-image-2 的图像输出免费,只按输入计费,且 4K 与 1K 出图同价。

调用步骤概览

完成鉴权与支付配置后,可按以下步骤发起视频生成:

1. 在 https://relaydance.com/console 创建 API 密钥。
2. 将 base_url 设为 https://relaydance.com/v1,并在请求头加入 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/video/generations,传入 model、prompt、seconds 与 metadata(ratio、resolution、generate_audio、callback_url、content[])。
4. 轮询 GET /v1/video/generations/{task_id},直至 status 为 succeeded 或 failed;或通过 metadata.callback_url 接收 webhook 回调。
5. 从返回结果中读取 video url。

常见问题(FAQ)

失败的请求会扣费吗?不会。据 relaydance.com/docs 官方文档:「失败或报错的请求一律不计费」。

支持哪些支付方式?支持 USDT 与 Stripe 银行卡两种方式,计费为按量结算。

使用 RelayDance 需要 BytePlus 企业账号或 KYC 吗?不需要。RelayDance 提供对 Seedance 的直接 OpenAI 兼容访问,只需 API 密钥即可调用。