invalid_api_key说明身份凭证失效，需依次验证密钥状态为enabled、authorization头格式为bearer后紧接密钥且无空格或隐藏字符、粘贴至记事本清理不可见符号并重输末尾3字符、环境变量加载时确认非空且以ds_开头符合规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
遇到DeepSeek报错时，不能盲目重试或换密钥，必须根据错误码精准定位问题根源：invalid_api_key说明身份凭证失效，rate_limit_exceeded代表请求节奏失控，model_not_found指向模型名或接口版本错配，400错误往往藏在JSON结构或thinking block传递缺失里。
密钥无效（invalid_api_key）怎么验
第一步：登录DeepSeek开发者控制台，进入API Keys管理页，确认目标密钥状态为【Enabled】且未显示过期时间。
第二步：检查代码中Authorization请求头是否严格写成Bearer后紧跟密钥字符串，中间【不能有空格、换行、全角字符或BOM头】。
第三步：把密钥粘贴进记事本，手动删掉首尾不可见符号，再重新输入最后3个字符——这一步能排除90%的复制粘贴污染问题。
第四步：若用环境变量加载，在运行前加一句print(os.getenv('DEEPSEEK_API_KEY'))，确保输出非空且以ds_开头、长度符合规范。
请求被限流（rate_limit_exceeded）怎么调
方法一：立即查看响应头X-RateLimit-Remaining和X-RateLimit-Reset字段，算出还剩几次配额、多久后重置。
方法二：在客户端代码里加指数退避逻辑——首次失败等1秒，再失败等2秒，接着4秒、8秒，最多重试5次，避免雪崩式重试。
方法三：检查是否有for循环没加sleep就连续发请求，改成单次chat请求里合并多个messages，或启用batch参数（如果接口支持）。
模型找不到（model_not_found）怎么查
打开DeepSeek官方文档Models页面，逐字核对所用model值是否与列表完全一致：deepseek-chat不能写成deepseek_chat、deepseek-v1或deepseek-chat-v2。
确认API Endpoint地址含/v1或/v2路径后缀，v1接口不认v2专属模型，v2接口也不接受v1旧模型名。
如果用的是DeepSeek V4，注意它只在/v2/chat/completions路径下可用，且model字段必须填deepseek-v4，不是deepseek-chat。
400错误反复出现怎么破
先用jsonlint.com校验整个请求体JSON格式，重点看括号是否闭合、末尾逗号是否多余、BOM头是否残留。
检查temperature、max_tokens等数值参数是否传了字符串类型，比如"0.7"要改成0.7，"2048"得改成2048。
如果是DeepSeek V4 + Claude Code组合，大概率是thinking block丢失导致——上一轮assistant返回了thinking内容，下一轮user却只传tool_result，漏掉了thinking字段。这时必须启用dsv4-cc-proxy代理，一行命令启动即可修复：dsv4-cc-proxy --port 8000，然后把API请求地址指向http://localhost:8000/v2/chat/completions。
