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."}}。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 从 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。
实操建议：
立即学习“Python免费学习笔记（深入）”；
-
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"，容易误判为正常输出。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 务必检查
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 简单、稳定、兼容性好。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 保持
requests>=2.31.0，旧版本可能不支持 HTTP/2 或证书验证异常 - 生产环境加
timeout=(10, 30)（连接 10 秒，读取 30 秒），避免卡死 - 不要在循环里反复创建
Session实例——复用一个session对象能显著提升并发性能
