调用DeepSeek API需完成密钥获取与安全存储、构造HMAC-SHA256签名请求头、发送合规JSON请求三步；漏任一环节将返回401/403错误，必须严格按流程操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
调用DeepSeek API需要完成从密钥获取、认证构造到请求发送的完整链路，漏掉任一环节都会返回401或403错误，无法获得模型响应。
获取API密钥与安全存储
登录DeepSeek开发者控制台→进入「API管理」→点击「创建密钥」→填写项目名称并选择权限范围（生产环境建议勾选“仅限服务器调用”）→生成后立即复制API Key和Secret Key。
【密钥一旦关闭页面将不可再次查看，必须立刻保存】
将两个密钥存入系统环境变量：DEEPSEEK_API_KEY和DEEPSEEK_SECRET_KEY。不要写进代码文件，更不要提交到Git仓库。
构造带签名的HTTP请求头
DeepSeek采用HMAC-SHA256签名机制，每请求必须包含三项头部字段：
方法一：手动拼接签名字符串
第一步：生成当前UTC时间戳（10位整数，如1722830645）
第二步：按规范拼接待签名字符串——HTTP方法\n路径\n空行\nhost:api.deepseek.com\nx-ds-date:时间戳\n\nhost;x-ds-date\n请求体SHA256哈希值
第三步：用Secret Key对字符串做HMAC-SHA256运算，Base64编码结果作为X-DS-Signature值
方法二：使用官方SDK（推荐）
执行pip install deepseek-sdk→导入from deepseek import DeepSeekClient→初始化时自动处理签名与重试逻辑。
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
发起文本生成请求
向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超限，需在重试逻辑中加入指数退避（首次延迟100ms，每次翻倍，最多重试3次）。
若返回400且error.message含“invalid prompt”，说明messages格式不合法——检查是否遗漏role字段或内容为空字符串。
