错误处理
API 请求失败时，先记录 HTTP 状态码和响应体，再检查鉴权、余额、模型名称与 JSON 格式。不要在日志或工单中暴露完整 API Key。
401：API Key 无效
确认使用 Bearer 前缀、Key 未被删除，并且请求头没有多余空格。若怀疑泄露，请轮换 Key。
余额或额度不足
进入控制台检查钱包余额及账户状态。文档不假设具体错误码或充值流程。
模型不可用
确认 model 值拼写正确，并在控制台核对当前开放模型。当前已验证模型为 deepseek-v4-flash。
请求格式错误
确认请求体是有效 JSON，包含 model 和 messages，并发送 Content-Type: application/json。
网络或上游暂时不可用
设置合理超时，并对可重试的临时错误使用带上限和退避的重试策略。不要对所有错误无限重试。
Last updated / 最后更新：