DeepSeek API错误码提示词模板：新手零基础快速上手

老实说，新手第一次调用DeepSeek API时，十有八九都栽在同一个坎上：对着错误信息一脸懵，连自己的API密钥是不是有效都拿不准。

最快的方法不是到处搜答案，而是学会让DeepSeek“精准报错”——把错误码直接喂给模型。

先锁定错误类型，再写提示词

操作很简单：打开API返回的JSON响应体，找到code字段——比如"invalid_api_key"这种值。这个字段里的内容，就是你写提示词时必须塞进去的核心关键词。千万别说“报错了”“出问题了”这类模糊用语，模型根本没法靠这种描述定位文档。

直接把复制好的code值粘贴到提示词开头，后面加冒号和空格。注意：这个格式就是触发DeepSeek精准查文档的钥匙。

举个例子，正确写法是：
【code: "model_not_found"】 请详细说明该错误的含义、常见触发场景、3种独立排查步骤，以及对应的修复代码（Python requests方式）。

新手友好型提示词四要素模板

直接复制这个模板，把方括号里的内容换成你自己的。别看简单，缺一项效果就打折：

【code: "[填入你看到的实际code值]"】 请用新手能听懂的语言解释：1）这个错误到底发生了什么；2）90%以上是由哪3个具体原因导致的；3）每个原因对应怎么检查（给出命令或截图位置）；4）修复后如何验证生效。不要列概念，只告诉我现在电脑上按什么顺序点、输什么、看哪里。

注意：方括号必须保留，code值要和API返回体里的内容完全一致——包括引号、大小写、下划线。差一个字符，模型都可能只给通用解释，而不是DeepSeek专属方案。

针对高频错误的预制提示词（直接复制用）

下面直接给出几种最常见报错场景对应的模板，复制就能用：

方法一：code为"invalid_api_key"时

【code: "invalid_api_key"】 我刚从DeepSeek控制台复制了密钥，粘贴到Python代码里运行就报这个错。请分步告诉我：1）去控制台哪个页面确认密钥状态是Enabled；2）用记事本清理隐藏字符的具体操作（比如Ctrl+A再Delete有没有用）；3）os.getenv()打印出来是None，是环境变量没设对还是名称拼错了；4）最后用curl命令手动测试一次的完整写法。

方法二：code为"rate_limit_exceeded"时

【code: "rate_limit_exceeded"】 我只是跑了5次for循环请求就触发限流，没动过配额设置。请告诉我：1）在哪里能看到当前剩余额度和重置时间（截图位置）；2）Python代码里加time.sleep(1)能不能解决问题；3）如果必须用指数退避，给出带retry次数限制和最大延迟的最小可行代码块；4）合并请求的batch参数在v1接口里到底支不支持（别让我猜）。

方法三：code为"400"时

【code: "400"】 返回体里message说"missing required field 'messages'"，但我的JSON里明明写了"messages"。请指出：1）messages字段必须是数组还是对象；2）数组里每条message必须含哪几个键（role/content必选？name可选？）；3）用json.dumps()序列化时ensure_ascii=False要不要加；4）贴一个能直接curl -X POST跑通的最简JSON示例（含header）。