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

Seedance API 返回 401 Unauthorized 时，说明请求的身份验证未通过，通常是 API key 缺失、拼写错误或请求头格式不对。RelayDance 采用 OpenAI 兼容协议，需在请求头中传入 Authorization: Bearer YOUR_API_KEY，并将 base_url 改为 https://relaydance.com/v1。API key 可在 https://relaydance.com/console 创建。修正请求头即可解除 401 错误。

401 错误的常见原因

401 Unauthorized 几乎都源于身份验证信息未被服务端正确接收。最常见的情况是请求头中缺少 Authorization 字段，或未使用 Bearer 前缀。其次是 API key 复制时带入了多余空格或换行符，导致 key 与控制台记录不匹配。此外，若 base_url 仍指向其他服务地址，请求可能到达错误的鉴权端点。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此确认 base_url 正确是排查第一步。请同时确认 key 是在 https://relaydance.com/console 内有效创建且未被删除。

逐步排查 401 的方法

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

1. 确认 base_url 设为 https://relaydance.com/v1，而非默认 OpenAI 地址。
2. 确认请求头格式为 Authorization: Bearer YOUR_API_KEY，注意 Bearer 与 key 之间只有一个空格。
3. 登录 https://relaydance.com/console 重新复制完整 API key，避免遗漏字符或带入换行符。
4. 用重新复制的 key 重试请求，确认 401 是否消失。
5. 若仍失败，检查环境变量是否被覆盖或缓存了旧 key。

值得注意的是，401 属于鉴权失败，不会产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此排查过程中的重试不会影响账单。

验证 API key 与请求配置

修正配置后，可用一个最小请求验证 API key 是否生效。使用 OpenAI SDK 时，只需在初始化客户端时同时设置 base_url 与 api_key 两项参数。RelayDance 提供 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 与 Grok 系列模型，鉴权通过后即可提交视频任务（POST /v1/video/generations）或图像任务（POST /v1/images/generations）。计费为按量付费：Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒。若鉴权成功但任务失败，同样不计费。各模型实时费率见 https://relaydance.com/models。

价格与配置参考

下表汇总排查时可参考的关键配置与计费信息。

RelayDance 提供直接的 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC。付款支持 USDT 与 Stripe 卡。

FAQ 常见问题

问：401 错误会产生费用吗？不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费，401 属于鉴权失败，不计入账单。

问：base_url 应该设为什么？设为 https://relaydance.com/v1，并保留 OpenAI SDK 即可调用，详见 https://relaydance.com/docs。

问：在哪里创建或重置 API key？在 https://relaydance.com/console 创建 key，请求头需使用 Authorization: Bearer YOUR_API_KEY 格式。