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

Seedance API 返回 401 Unauthorized，通常是 API key 无效、缺失或请求头格式错误导致的。请检查 Authorization: Bearer YOUR_API_KEY 是否正确附带，密钥是否在 https://relaydance.com/console 创建且未删除，并确认 base_url 已改为 https://relaydance.com/v1。由于 RelayDance 采用 OpenAI 兼容协议，鉴权方式与 OpenAI SDK 一致。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。

401 错误的常见原因

401 Unauthorized 表示服务器无法验证你的身份，核心原因集中在 API key 与请求头。首先确认请求携带了 Authorization: Bearer YOUR_API_KEY，其中 Bearer 与密钥之间需有一个空格。其次，密钥必须在 https://relaydance.com/console 生成且未被删除或撤销。第三，base_url 若仍指向 OpenAI 官方地址，请求会被拒绝，应改为 https://relaydance.com/v1。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此除 base_url 与密钥外，无需改动其他 SDK 配置。

逐步排查步骤

按以下 6 个步骤可定位大多数 401 问题。

1. 在 https://relaydance.com/console 确认密钥存在且状态为启用。
2. 检查请求头是否为 Authorization: Bearer YOUR_API_KEY，注意大小写与空格。
3. 确认 base_url 已设为 https://relaydance.com/v1，而非 OpenAI 官方地址。
4. 排查密钥是否含多余空格、换行或引号，环境变量注入时常出现此类问题。
5. 重新生成一个新密钥并替换测试，以排除旧密钥被撤销。
6. 确认账户支付方式（USDT 或 Stripe card）已配置，避免因账户异常触发鉴权失败。

401 与其他错误的区分

401 属于鉴权层错误，需与计费层和参数层错误区分开。若请求因参数错误或模型内部原因失败，返回的不是 401，而且不会产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此在排查 401 时不必担心重试产生额外扣款。下表对比几类常见状态。

验证密钥可用的最小请求

确认密钥有效的直接方法是发起一次最小成本调用并轮询结果。使用 POST /v1/video/generations 提交任务，携带 model、prompt 与 seconds，然后用 GET /v1/video/generations/{task_id} 轮询至 succeeded 或 failed。若返回 200 而非 401，说明鉴权已通过。参考计价，Seedance Fast 约 $0.152 / 秒，Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，原生 4K 约 $4.90 / 5 秒条，实时费率见 https://relaydance.com/models。测试建议使用较短秒数以控制成本。

常见问题 FAQ

问：改了 base_url 仍报 401 怎么办？请重新在 https://relaydance.com/console 生成新密钥，并检查请求头是否为 Authorization: Bearer YOUR_API_KEY，确认无多余空格或换行。

问：使用 RelayDance 需要 BytePlus 企业账号或 KYC 吗？不需要。RelayDance 提供 OpenAI 兼容的直接访问，无需 BytePlus 企业账号或 KYC。

问：排查 401 时反复重试会被扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，仅按成功生成的视频按量计费。