我刚踩完DeepSeek API的坑，分享点实战经验。事情是这样的：上个月要给自己的开源项目加个对话助手，一看文档有四个版本——chat、reasoner、v4-flash、v4-pro。挨个试了一遍，有的响应快但逻辑弱，有的推理强但慢得像牛车。选择版本本身就是一个大坑，先搞清楚再说。
---
你只需要三样东西：
1. DeepSeek账号 – 去官网注册，个人开发者用手机号就行。
2. API Key – 登录后在控制台API Keys页面创建，建议每个项目单独建一个Key，方便管理。
3. 网络环境 – 如果无法直连，需要准备代理（HTTP_PROXY环境变量）。
各版本区别一句话：
- chat（对应deepseek-chat）：性价比之王，上下文128K，日常问答、内容生成首选。
- reasoner（deepseek-reasoner）：思维链推理，数学、代码、逻辑题专用，但响应慢。
- v4-flash（deepseek-v4-flash）：极速模型，适合需要低延迟的场景（比如流式对话）。
- v4-pro（deepseek-v4-pro）：最新最强，但成本高，只有付费额度充足时才建议用。
个人开发者建议：默认先上chat版本，除非你明确需要思维链（reasoner）或超低延迟（flash）。v4-pro只做评测用，别在生产环境当小白鼠。
---
def ask_deepseek(prompt, model="deepseek-chat"): api_key = os.getenv("DEEPSEEK_API_KEY") if not api_key: raise ValueError("请设置 DEEPSEEK_API_KEY 环境变量") headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" } payload = { "model": model, # 关键：换成 deepseek-reasoner / deepseek-v4-flash / deepseek-v4-pro "messages": [ {"role": "user", "content": prompt} ], "temperature": 0.7, "max_tokens": 2048 } response = requests.post( "https://api.deepseek.com/chat/completions", headers=headers, json=payload ) return response.json()["choices"][0]["message"]["content"]
常见错误：401 – Key无效或过期；429 – 频率超限，加time.sleep()重试；400 – 检查model名称是否拼错。
有个小诀窍：把主要逻辑用chat版本，遇到用户问复杂数学/代码时，自动切换到reasoner版本。这样既省钱又灵活。
---
DeepSeek API最让人省心的是兼容OpenAI格式，迁移成本几乎为零。版本选择上，记住一个原则：默认chat，特殊需求才换。申请Key一分钟就能搞定，用requests库5行代码可调通。建议先在个人项目里跑一轮，观察响应速度和成本，再考虑上生产。如果遇到报错，优先检查网络和Key，其次看模型名是否写对。最后提醒一句：API Key不要硬编码到代码里，用环境变量管理，这是基本素养。