错误排查

401 / 403

检查 API Key 是否完整、是否被禁用，以及分组是否允许当前接口。Anthropic 原生接口还要确认客户端发送了正确的 anthropic-version。

404 model not found

模型名称必须使用分组实际支持的名称。先请求模型列表，或在控制台查看分组模型配置，不要直接照抄其他平台的模型名。

429 Too Many Requests

常见原因：账号并发已满、上游限流、用户或分组 RPM 限制。降低并发、等待 Retry-After、切换可用分组，并在使用记录中确认是否发生了账号切换。

5xx 或 upstream timeout

长文本、图片和视频请求可能耗时较长。服务端调用应提高超时；Seedance 创建任务后应轮询任务状态，不要在客户端重复提交创建请求。

浏览器跨域问题

长期 API Key 不建议放在前端。浏览器直连还会受到 CORS、代理和密钥泄露风险影响，生产环境应通过自己的后端转发。