DeepSeek API调用完整流程

调用DeepSeek API其实没那么玄乎，流程上就三件事：拿到密钥、构造签名、发请求。但每一步都有坑，稍不注意就接不到模型响应，直接给你甩个401或者403。那下面就把这几个步骤拆开来说清楚，按着走基本不会出问题。

说起来，整个调用链路从密钥获取到认证构造再到请求发送，确实是一个都不能少。那些时序错乱或格式跑偏的请求，都会吃到标准的401或者403错误，想拿模型回复？门都没有。

获取API密钥与安全存储

操作流程很直接：登录DeepSeek开发者控制台，进入「API管理」页面，点击「创建密钥」，填好项目名称，再选好权限范围。生产环境的话，建议勾选“仅限服务器调用”这个选项。生成之后，系统会给你一个API Key和一个Secret Key，这个时候必须立刻复制保存，因为一旦关闭这个页面，密钥就再也看不到了。

至于存储，规矩很明确：把这两个密钥分别存入系统环境变量，名字就叫DEEPSEEK_API_KEY和DEEPSEEK_SECRET_KEY。千万别把它们直接写进代码文件里，更不要手一抖提交到Git仓库。这个教训，市场上已经有不少人替你交过学费了。

构造带签名的HTTP请求头

DeepSeek这边用的是HMAC-SHA256签名机制，每次请求都得带上三项头部字段。具体操作有两种办法。

方法一，手动拼接签名字符串。第一步，先取一个当前UTC时间戳，10位整数的那种，比如1722830645。第二步，按规范拼接待签名字符串，格式是HTTP方法 路径 空行 host:api.deepseek.com x-ds-date:时间戳 host;x-ds-date 请求体SHA256哈希值。第三步，用Secret Key对这个字符串做HMAC-SHA256运算，然后Base64编码一下，结果作为X-DS-Signature的值。这一步看着有点繁琐，但逻辑其实很清晰。

方法二，用最新SDK，这个更推荐，省心不少。直接执行pip install deepseek-sdk，然后from deepseek import DeepSeekClient，初始化的时候SDK会自动处理签名和重试逻辑，连手动拼字符串的功夫都省了。

发起文本生成请求

请求地址是POST https://api.deepseek.com/v1/chat/completions，发送一个JSON格式的请求体。里面必须包含model字段，比如deepseek-chat-7b，还有messages字段，这个是数组格式，至少得有一个{"role": "user", "content": "你的问题"}。

还有一些可选参数，但强烈建议加上。比如temperature，范围在0.1到1.0之间，设为0.3能有效减少幻觉；还有max_tokens，防止模型无限生成导致超时。实际操作起来也很简单，直接把构造好的headers和data传给requests.post就行，没什么复杂的。

解析响应并捕获关键错误码

如果一切顺利，响应状态码是200，返回的JSON中choices[0].message.content就是模型生成的文本。但万一遇到429错误，说明QPS超限了，这时候需要在重试逻辑里加上指数退避，首次延迟100毫秒，每次翻倍，最多重试3次。如果返回400，而且error.message里包含“invalid prompt”，那多半是messages格式出了问题——检查一下是不是漏了role字段，或者内容是不是空字符串。这些细节，在调试阶段尤其容易踩坑。