deepseek api 必须使用 authorization: bearer 头传入 sk-xxx 格式 token,仅支持 deepseek-chat 模型,messages 必须含至少一个 role 为"user"的条目且为 json 格式,响应 content 可能为空需主动校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

DeepSeek API 的认证方式必须用 Bearer Token
DeepSeek 官方 API(如 https://api.deepseek.com/v1/chat/completions)不支持 API Key 放请求体或 form data,只接受标准的 Authorization: Bearer <token></token> 头。常见错误是把 token 直接塞进 json 参数里,结果返回 401 Unauthorized 或 {"error": {"message": "Invalid token."}}。
实操建议:
- 从 DeepSeek Platform 创建 API Key 后,复制完整字符串(以
sk-xxx开头),不要删空格、换行 - 请求时务必通过
headers传入:{"Authorization": "Bearer sk-xxx"},不是"Bearer sk-xxx "(尾部空格会失败) - Token 有权限范围,免费版仅支持
deepseek-chat模型,调用deepseek-coder会返回404 Not Found
发送 chat/completions 请求必须用 JSON 格式且 messages 是必需字段
和 OpenAI 兼容,但 DeepSeek 对 messages 结构更严格:不能缺 role(只能是 "system"、"user"、"assistant"),且至少含一个 "user" 条目。空 messages 或错写成 message(少 s)直接 400。
实操建议:
-
model必须显式指定为"deepseek-chat"(当前唯一开放模型) -
messages至少包含一条{"role": "user", "content": "..."},system角色可选但推荐加(用于设定行为) - 不要传
stream=True除非你已准备处理 SSE 流——默认同步响应更快、更稳定
最小可用示例:
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())
响应结构与 OpenAI 高度一致,但 content 字段可能为空
成功响应中 choices[0].message.content 是你要的答案,但 DeepSeek 在极少数情况下(如输入含敏感词、长度超限)会返回空字符串而非报错,此时 finish_reason 可能是 "stop" 或 "length",容易误判为正常输出。
实操建议:
- 务必检查
resp.status_code == 200且resp.json().get("choices")非空 - 读取
content前先判断是否存在:msg.get("content") or "",避免KeyError - 若
finish_reason == "length",说明被截断,需调整max_tokens或拆分输入
Python 中用 requests 调用足够,无需额外 SDK
DeepSeek 官方暂未发布 Python SDK,社区也无成熟封装。强行用 openai 包改 base_url 会因 header 默认行为(如自动加 OpenAI-Beta)导致 401;用 httpx 也无必要——requests 简单、稳定、兼容性好。
实操建议:
- 保持
requests>=2.31.0,旧版本可能不支持 HTTP/2 或证书验证异常 - 生产环境加
timeout=(10, 30)(连接 10 秒,读取 30 秒),避免卡死 - 不要在循环里反复创建
Session实例——复用一个session对象能显著提升并发性能
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











