按项目统计 API 花费：用 RelayDance 用量日志做成本归因

在 RelayDance 上按项目做成本归因，核心方法是为每个项目分配独立 API Key，并结合按量计费的用量日志汇总每次生成的实际支出。RelayDance 采用 OpenAI 兼容协议，计费按生成的视频或图像逐条累计，失败请求不计费，因此项目成本等于该 Key 下所有成功任务的费用之和。配合 Seedance 各档单价即可精确核算。

为什么用独立 API Key 做项目归因

成本归因的第一步是让每个项目使用独立的 API Key，以便在用量日志中区分归属。RelayDance 使用 Authorization: Bearer YOUR_API_KEY 进行鉴权，密钥可在 https://relaydance.com/console 创建，为不同项目分别建 Key 后，每条调用记录都可映射到对应项目。由于计费为 pay-as-you-go，按生成的视频逐条累计，Key 维度的日志汇总即等于项目实际支出。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此归因时只需统计成功任务，无需为报错请求做扣除或对账修正，核算逻辑更简单。

各档单价与成本核算

项目成本核算的关键是把成功任务数量乘以对应模型的单价，单价可在 https://relaydance.com/models 查询。以下为部分参考单价，用于估算每个项目的支出。

举例：某项目在 720p 档生成 10 段各 5 秒的视频，单价约 $0.190 / 秒，成本约为 $9.50。gpt-image-2 的图像输出免费，只按输入计费，4K 与 1K 出图同价，图像项目的核算按输入维度进行。

接入用量统计的步骤

接入按项目统计只需在现有 OpenAI SDK 基础上切换配置并分配密钥即可完成。据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需改动其余代码。

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 等参数。
4. 轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed。
5. 按 Key 维度汇总成功任务，乘以对应单价得到项目成本。

更多接口说明见 https://relaydance.com/docs。

参数与限制对成本的影响

影响单个项目成本的主要因素是分辨率、时长与参考媒体数量。视频单价按秒或按条计价，例如 1080p 约 $0.470 / 秒高于 720p 的约 $0.190 / 秒，选择档位会直接改变支出。单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，单个片段时长最长 15 秒，参考媒体放入 metadata.content[] 并在 prompt 中以 @image1 到 @imageN 引用。支付方式支持 USDT 与 Stripe card。由于失败请求不计费，成本归因时以成功任务的秒数或条数为唯一计量基准。

常见问题 FAQ

失败的请求会计入项目成本吗？

不会。失败或报错的请求一律不计费，成本归因只需统计成功任务。

如何区分不同项目的花费？

为每个项目在 https://relaydance.com/console 创建独立 API Key，按 Key 维度汇总用量日志即可。

接入是否需要修改现有代码？

不需要大改。保留 OpenAI SDK，将 base_url 改为 https://relaydance.com/v1 并配置对应 API Key 即可调用。