Python调用DeepSeek API完整指南：从入门到实战代码示例
在Python项目中集成DeepSeek API，接口设计看似直观，但开发者常因忽略几个关键细节而遭遇调用失败。本文将直接切入核心，解析那些导致请求返回401或400错误的典型配置问题，并提供可直接部署的解决方案。
认证配置：正确设置Bearer Token与请求头
认证失败是首要障碍。DeepSeek API端点（如https://api.deepseek.com/v1/chat/completions）严格遵循HTTP Bearer Token认证标准，仅识别通过Authorization头传递的密钥。将API Key错误地放置在请求体json参数中，是触发401 Unauthorized或“Invalid token”提示的常见原因。
配置时需遵循以下协议：
- 从DeepSeek控制台获取API Key后，完整复制以
sk-xxx开头的字符串，确保未引入首尾空格或换行符。 - 在请求头中，必须通过
headers参数设置：格式为{"Authorization": "Bearer sk-xxx"}。注意“Bearer”与密钥间仅有一个空格，尾部不留空格。 - 同时，需确认API Key的模型权限。当前免费版本仅授权访问
deepseek-chat模型。误调用deepseek-coder等未授权模型将返回404 Not Found。
请求体构建：严格规范messages字段结构
DeepSeek API与OpenAI接口高度兼容，但对messages字段的格式校验更为严格。该字段必须存在且为非空列表，其中至少包含一个role为"user"的字典对象。缺失该字段或误写为message将直接导致400错误。
构建请求体的关键参数如下：
model参数必须明确指定为"deepseek-chat"（当前唯一开放的通用对话模型）。messages列表中，必须包含如{"role": "user", "content": "你的问题"}的条目。可选的system角色常用于设定AI的行为边界与上下文。- 除非应用场景需要处理流式响应，否则不建议启用
stream=True。对于多数同步任务，默认的请求-响应模式更稳定且易于调试。
以下为经过验证的最小可行代码示例：
import requests
url = "https://api.deepseek.com/v1/chat/completions"
headers = {"Authorization": "Bearer sk-xxx", "Content-Type": "application/json"}
data = {
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好，请用中文简单介绍自己"}]
}
resp = requests.post(url, headers=headers, json=data)
print(resp.json())
响应处理：精准解析content与finish_reason字段
收到200状态码仅表示请求被接受，有效响应内容位于choices[0].message.content路径下。需注意，当输入触发内容安全策略或超出长度限制时，API可能返回空的content字符串，而非直接报错。此时finish_reason字段可能显示为"stop"或"length"，易被误判为正常结束。
建议采用以下健壮性处理逻辑：
- 除检查
resp.status_code == 200外，需验证resp.json().get("choices")列表非空。 - 读取
content前，使用msg.get("content") or ""的写法，避免潜在的KeyError异常。 - 若
finish_reason值为"length"，表明回复因令牌限制被截断。此时应调整max_tokens参数值，或考虑将复杂查询拆分为多个连续请求。
依赖与环境：推荐使用requests库并配置超时
目前DeepSeek未提供官方Python SDK。试图通过修改openai库的base_url进行调用常会失败，因为该库会自动添加专有请求头（如OpenAI-Beta），导致服务器返回401。社区第三方封装库尚不成熟，因此直接使用requests库是最可靠的选择。httpx库虽功能相似，但在此场景下并无额外优势。
生产环境部署建议：
- 确保
requests库版本不低于2.31.0，旧版本可能存在HTTP/2支持或SSL证书验证问题。 - 务必为所有API请求设置超时参数，例如
timeout=(10, 30)（10秒连接超时，30秒读取超时），防止因网络延迟导致进程阻塞。 - 高频调用场景下，应复用
requests.Session()对象，而非在循环中反复创建。这能显著提升连接效率并降低系统开销。
总结而言，DeepSeek API在Token校验敏感性、内容截断处理逻辑及模型名称硬编码等方面与OpenAI存在细微差异。明确这些区别，即可确保API集成流程一次成功。