前阵子想给自己的小工具接入AI，翻DeepSeek文档发现一堆版本名：chat、reasoner、v4-flash、v4-pro。看半天没搞懂该用哪个，照着示例调接口还总报错。后来花了一下午踩坑才理清楚。这次把经验写出来，供同行参考。
你需要一个DeepSeek账号（注册很简单，用邮箱或手机号），然后登录控制台创建一个API Key。记得把Key存好，很多新手就是在这里漏了环境变量。另外准备一个Python环境，pip install requests就够了，不需要额外的第三方库——DeepSeek的API是标准的OpenAI兼容格式，直接用openai库也可以，但我更习惯用裸requests避免依赖冲突。
DeepSeek有四个主要版本，实际用起来区别很明显：
- chat：最通用的对话模型，响应快，成本低。适合聊天机器人、简单问答。缺点是复杂推理不行。 - reasoner：专门加强推理能力，数学、逻辑题明显比chat强。但速度稍慢，价格也贵一点。 - v4-flash：v4系列的“快餐版”，速度快，适合需要实时响应的场景（比如实时翻译、代码补全）。代价是准确性不如pro。 - v4-pro：旗舰版，知识和推理能力最强，但延迟高、费用也高。适合对结果质量要求苛刻的任务。
我的建议：开始先用chat做原型，如果遇到逻辑问题再切reasoner。需要低延迟就上flash，追求极佳效果用pro。别一上来就上pro，钱包受不了。
登录DeepSeek控制台，左边菜单找到“API Keys”，点创建。给Key取个名字，复制出来。然后设置环境变量（别写在代码里）：
写代码时用os.getenv("DEEPSEEK_API_KEY")读取。Windows用户用set DEEPSEEK_API_KEY=xxx，或者直接写个.env文件调用python-dotenv。
DeepSeek的接口地址是https://api.deepseek.com/v1/chat/completions，和OpenAI一模一样。下面是一个完整的Python调用：
api_key = os.getenv("DEEPSEEK_API_KEY") url = "https://api.deepseek.com/v1/chat/completions"
payload = { "model": "deepseek-chat", # 替换成你选的版本：deepseek-reasoner, deepseek-v4-flash, deepseek-v4-pro "messages": [ {"role": "system", "content": "你是一个编程助手，用简洁的代码解答问题。"}, {"role": "user", "content": "用Python写一个快速排序"} ], "temperature": 0.7, "max_tokens": 1024 }
headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" }
resp = requests.post(url, json=payload, headers=headers)
resp.raise_for_status()
print(resp.json()["choices"][0]["message"]["content"])
`
注意：model参数必须填对。如果不确定，可以直接在控制台的“在线体验”里测试不同模型，复制那个模型名称。另外max_tokens别设太小，不然答案会被截断；也别太大，防止浪费。
- 401 Unauthorized：API Key没设对，检查环境变量或是否有空格。
- 400 Bad Request：通常是因为messages格式不对，或者模型名写错。打印出payload看看。
- 429 Rate Limit：免费版有调用次数限制，控制台里可以看到配额。如果频繁遇到，检查代码里有没有循环发请求，加个time.sleep。
选模型时记住：按任务特征做性价比权衡，不要迷信“最大最强”。刚开始用chat做验证，等逻辑瓶颈出现再升级。调用时坚持用环境变量保存Key，代码保持整洁。如果想深入调参，玩一玩temperature和top_p，但大多数场景默认值就够用。最后，DeepSeek的文档写得挺清楚（尤其是Chat Completions章节），遇到奇怪错误先翻一遍，90%问题都能找到答案。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。