记得第一次接触DeepSeek API时，项目正需要做一个智能问答助手。文档里列出了四个版本：chat、reasoner、v4-flash、v4-pro，名称相似但功能描述模棱两可。试了几个请求，有的返回特别慢，有的推理深度不够，还有的明明用对了参数却一直报错。折腾半天才搞明白，原来不同版本的适用场景差异很大，加上鉴权配置没做对，白白浪费了不少token。
你需要一个DeepSeek账号，去官网注册就行，免费额度够个人实验。注册成功后进入控制台，找到“API Keys”页面，创建一个新的key。注意复制后保存好，关闭页面后就看不到了。另外，建议装好Python 3.8+和requests库，后面演示用。
- chat：最基础的对话模型，响应快、成本低，适合日常问答、文本生成，比如做客服机器人或内容辅助。如果对推理深度要求不高，首选它。 - reasoner：专门优化了逻辑推理和数学计算，适合需要多步推导的场景，比如代码debug、数学解题。响应稍慢，但思考链条清晰。 - v4-flash：v4系列的轻量版，速度和chat差不多但理解能力更强，适合对响应时效和内容质量有平衡要求的应用。 - v4-pro：全量版，推理深度和准确性最高，但速度最慢、价格最贵。适合处理复杂任务，比如长文档分析、高质量翻译、专业领域问答。
个人开发者做原型，先选chat或v4-flash试水，性价比够用。若有明确推理需求再切reasoner。
1. 环境准备
确保Python环境，安装requests：
`bash
pip install requests
`
2. 基础请求代码
下面示例演示如何用API Key调用chat版本。注意将YOUR_API_KEY替换成你自己的key：
url = "https://api.deepseek.com/v1/chat/completions" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } data = { "model": "deepseek-chat", "messages": [{"role": "user", "content": "解释一下深度学习中的反向传播"}] }
resp = requests.post(url, headers=headers, json=data)
print(resp.json()["choices"][0]["message"]["content"])
`
3. 切换版本
只需修改model字段：
- deepseek-chat → chat版
- deepseek-reasoner → reasoner版
- deepseek-v4-flash → v4-flash
- deepseek-v4-pro → v4-pro
例如调用reasoner版本，改model为"deepseek-reasoner"即可。注意v4系列可能需额外参数，看官方文档确认。
4. 错误处理 常见错误401：检查API Key是否有效，或是否已过期。错误400：检查请求体格式（特别是messages结构）。建议加个try-except捕获异常。
从实际经验看，新手最容易踩的坑是版本选错（用chat去解数学题，结果答非所问）和API Key泄漏（不小心传到了git仓库）。建议先在本地用chat快速验证功能逻辑，再根据瓶颈切换到对应版本。另外，别贪图v4-pro的“强大”——个人项目响应慢且烧token，真的没必要。保持请求结构清晰，监控token消耗，开发效率高很多。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。