DeepSeek API调用报错需按错误码定位问题：401/403查密钥与请求头，400校验JSON结构，429处理限流，504排查网络；再逐项验证密钥格式、Authorization头、model字段、messages结构、数值类型及DNS连接。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
DeepSeek API调用报错时，你正卡在请求发出后返回的错误响应里，看不到模型输出，也找不到具体哪一步写错了——不是服务崩了，而是你的请求和DeepSeek的“契约式校验”对不上号。
先看错误码，锁定问题类型
拿到错误响应后，第一眼盯住error.code或HTTP状态码，别急着改代码。
401 Unauthorized：密钥无效或Authorization头格式错；403 Forbidden：密钥没权限或被限制访问范围；400 Bad Request：JSON结构、字段名、数值类型不合规范；429 Too Many Requests：配额超限；504 Gateway Timeout：请求根本没进到服务端，卡在网络链路上。
这一步必须做，否则后续所有排查都是盲目的。
查API密钥与请求头
方法一：用curl快速验证密钥有效性
在终端执行：curl -X GET "https://api.deepseek.com/v1/models" -H "Authorization: Bearer sk-xxx" -H "Content-Type: application/json"，把sk-xxx替换成你的密钥。返回200 JSON列表说明密钥可用；返回401/403则问题出在密钥本身或头格式。
方法二：检查Authorization头是否严格为Bearer 后紧跟密钥，中间只有一个半角空格，【不能有换行、全角空格、中文引号或前后不可见字符】。
方法三：在Python中用print(repr(os.getenv('DEEPSEEK_API_KEY')))查看密钥真实值，确认长度符合ds_xxx或sk_xxx格式，且首尾无'\u200b'类零宽字符。
校验请求体JSON结构
第一步：确认model字段值拼写完全准确，必须是文档当前支持的完整字符串，例如"deepseek-chat"，【不能是"deepseek_chat"、"deepseek-v1"或漏掉末尾的"-chat"】。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
第二步：检查messages是否为非空数组，每个元素必须含role和content，且role只能是"system"、"user"或"assistant"——多一个"tool"或写成"User"都会触发400。
第三步：数值型参数如temperature、max_tokens必须传原始数字，"0.7"要改成0.7，"1024"要改成1024，字符串形式会被强校验拒绝。
第四步：把整个请求体粘贴到jsonlint.com，验证括号闭合、逗号结尾、BOM头等低级语法问题——这类错误不会报具体字段，只回{"error": {"message": "invalid request"}}。
排查网络与DNS问题
执行nslookup api.deepseek.com 8.8.8.8和nslookup api.deepseek.com 114.114.114.114，如果两次返回IP不一致，说明本地DNS被污染，请求可能被劫持到假地址。
运行telnet api.deepseek.com 443，若连接失败，切换手机热点再试——能通说明是公司防火墙或校园网屏蔽了443端口。
在Python调试时临时加一句import ssl; ssl._create_default_https_context = ssl._create_unverified_context，排除TLS证书校验失败导致的504。
处理速率限制（429）
方法1：读取响应头中的X-RateLimit-Remaining和X-RateLimit-Reset，算出重置时间戳，休眠对应秒数再重试。
方法2：在客户端实现指数退避，首次延迟1秒，失败后依次延迟2秒、4秒、8秒，最大重试5次。
方法3：检查代码里有没有for循环直接发请求，改成批量合并messages单次提交，或启用batch参数（如接口支持）。
