RelayDance API 鉴权、密钥与支付

RelayDance 的 API 鉴权使用 HTTP 请求头 Authorization: Bearer YOUR_API_KEY,密钥在控制台 https://relaydance.com/console 创建。接口为 OpenAI 兼容,只需将 base_url 改为 https://relaydance.com/v1。支付方式包括 USDT 与 Stripe 银行卡,采用按生成量计费(pay-as-you-go),失败或报错的请求不计费。

如何完成 API 鉴权

RelayDance 通过 Bearer Token 完成鉴权:在每次请求的请求头中传入 Authorization: Bearer YOUR_API_KEY。密钥在 https://relaydance.com/console 创建并管理。由于接口兼容 OpenAI 协议,迁移时无须更换 SDK。据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。视频任务通过 POST /v1/video/generations 提交,图像任务通过 POST /v1/images/generations 提交。提交后可轮询 GET /v1/video/generations/{task_id},直到 status 变为 succeeded 或 failed,结果中包含视频 url。详细计费见 https://relaydance.com/models。

密钥创建与接口调用方式

密钥在 https://relaydance.com/console 创建,接口调用沿用 OpenAI 兼容协议。提交视频任务时,请求体包含 model、prompt、seconds 及 metadata(ratio、resolution、generate_audio、callback_url、content[] 参考媒体)。参考媒体放在 metadata.content[] 中,并在 prompt 内以 @image1 到 @imageN 引用,每次请求最多支持 9 张参考图、3 段参考视频与 3 条音轨,片段时长可达 15 秒。除轮询外,也可设置 metadata.callback_url 使用 Webhook 模式,最终状态会 POST 到你的服务器。无需 BytePlus 企业账户或 KYC,即可直接访问 Seedance。

支付方式与计费规则

RelayDance 支持 USDT 与 Stripe 银行卡两种支付方式,计费为按生成量结算。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,即仅对成功生成的视频或图像收费。各模型实时费率以 https://relaydance.com/models 为准。下表列出部分单价(来源 relaydance.com/models):

从鉴权到出片的操作步骤

完成鉴权后,可按以下编号步骤生成视频:

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 SDK 的 base_url 设为 https://relaydance.com/v1,并在请求头加入 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/video/generations,传入 model、prompt、seconds 及 metadata 参数。
4. 如需参考媒体,放入 metadata.content[](最多 9 张图、3 段视频、3 条音轨),并在 prompt 中以 @image1 等引用。
5. 轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed,或设置 metadata.callback_url 接收 Webhook 回调。
6. 从结果中读取视频 url,失败或报错的请求不计费。

常见问题(FAQ)

问:鉴权需要哪些请求头?

答:需在请求头中加入 Authorization: Bearer YOUR_API_KEY,密钥在 https://relaydance.com/console 创建。

问:失败的请求会被收费吗?

答:不会,失败或报错的请求一律不计费(来源 relaydance.com/models)。

问:支持哪些支付方式?

答:支持 USDT 与 Stripe 银行卡,采用按生成量计费(pay-as-you-go),实时费率见 https://relaydance.com/models。