常见问题解答

请检查：1) Authorization Header 格式是否正确（Bearer 后面跟一个空格再写 API Key）；2) API Key 是否已过期或被删除；3) 是否使用了正确工作空间的 API Key。

HTTP 429 表示触发限流。请遵循响应中的 Retry-After，并使用指数退避后重试。需要提高限额时，请联系支持或管理员申请调整。

进入控制台“用量日志”页面，可按时间、模型和 API Key 筛选，查看每次调用的详细消耗记录和费用明细。

余额是工作空间用于 API 请求的可用资金。HTTP 402 对外统一表示可用余额或配额不足。充值可以增加余额，但不会自动提高配额；余额不是订阅计划。

配额是账号当前可使用额度的上限。余额代表可用资金，配额代表可使用额度；两者相互独立。需要调整限额时，请联系支持或管理员。

HTTP 402 表示可用余额或配额不足。请在账单、API Key 和工作空间的用量页面确认余额与上限；充值只能增加余额，不能自动提高配额。确认两者都充足后，再检查模型是否可用，以及请求是否使用了正确的工作空间。

请确认当前请求使用的 API Key 属于已调整的工作空间，并检查 Key 是否已禁用、过期或设置了更小的独立配额。用量和余额可能存在短暂同步延迟；如果控制台状态已更新但请求仍持续失败，请保留请求时间、脱敏后的 Key 标识和 request ID 联系支持，不要发送完整 API Key。

502/504 都属于网关层错误：502 通常表示网关从上游服务商收到无效响应或连接失败；504 表示上游服务商或网关等待链路超时。仅凭状态码不能直接判断是上游服务商故障还是 Token Market 网关自身故障，请结合 request ID、实际服务商和请求日志中的 error reason 定位。对于可安全重试的请求，使用带抖动的指数退避，并考虑开启回退或放宽筛选；流式或非幂等生成不要盲目重复提交，以免重复计费或重复生成。持续出现时，请提供请求时间、模型、服务商和 request ID 联系技术支持。

可通过控制台右下角的“反馈”入口提交工单，或发送邮件至 support@tokensapi.cn。