Seedance API 报 401 Unauthorized：RelayDance API key 无效错误排查

Seedance API 返回 401 Unauthorized 通常表示 API key 无效或认证头格式错误。请检查请求是否包含 Authorization: Bearer YOUR_API_KEY，确认 key 是在 https://relaydance.com/console 创建且未被删除，并确保 base_url 已改为 https://relaydance.com/v1。由于 RelayDance 采用 OpenAI 兼容协议，认证逻辑与 OpenAI SDK 一致。

401 错误的常见原因

401 Unauthorized 最常见的原因是认证头缺失、格式错误或 API key 失效。RelayDance 要求在每个请求中传入 Authorization: Bearer YOUR_API_KEY，其中 Bearer 与 key 之间需保留一个空格。若 key 已在控制台删除或从未创建，服务端会直接返回 401。另一个常见场景是把 OpenAI 的官方 key 直接用于 RelayDance，这会导致认证失败。请在 https://relaydance.com/console 确认 key 状态，并核对是否复制了完整字符串（无多余空格或换行）。认证失败不涉及计费，据 relaydance.com 官方文档：「失败或报错的请求一律不计费」(relaydance.com)。

排查步骤

按以下顺序排查可定位多数 401 问题。

1. 确认 base_url 已设为 https://relaydance.com/v1，而非 OpenAI 默认地址。据 relaydance.com 官方文档：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」(relaydance.com/docs)。
2. 检查请求头是否为 Authorization: Bearer YOUR_API_KEY，注意单词拼写与空格。
3. 登录 https://relaydance.com/console 核对 key 是否有效、是否被撤销。
4. 重新生成一个 key 并替换环境变量，避免使用过期或泄露的 key。
5. 用最简请求（如 POST /v1/images/generations）单独验证认证是否通过。

认证头配置对照

下表列出正确与常见错误的认证配置写法。

确认计费不受失败请求影响

排查 401 时无需担心费用，因为失败或报错的请求不计费。RelayDance 采用按生成量计费（pay-as-you-go），只有成功生成的内容才会扣费。参考 https://relaydance.com/models 的实时费率：Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，原生 4K 约 $4.90 / 5 秒条。而 gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。因此在反复测试认证时产生的 401 请求不会带来成本。

FAQ

401 和 403 有什么区别？401 表示认证失败（key 无效或缺失），403 通常表示认证通过但权限不足。遇到 401 时优先检查 Authorization 头与 key 状态。

可以直接用 OpenAI 的 API key 吗？不可以。需在 https://relaydance.com/console 创建 RelayDance 的 key，并将 base_url 改为 https://relaydance.com/v1。

反复测试认证会被扣费吗？不会。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」(relaydance.com)，401 属于失败请求，不计入费用。