上个月我做一个智能客服项目，想用大模型做意图识别。试了GPT-4太贵，本地模型效果差，直到发现DeepSeek。但问题来了：chat、reasoner、v4-flash、v4-pro……光看名字就头疼。选错版本意味着返工重写，甚至上线后效果翻车。这篇就是从踩坑经历里整理出的调用指南，帮你少走弯路。
注册DeepSeek账号，在控制台拿到API Key。这个Key就是你的通行证，跟密码一样别泄漏。环境方面，Python 3.8以上，装好requests库（pip install requests）。如果你熟悉OpenAI的SDK，DeepSeek完全兼容OpenAI的接口格式，可以直接用openai库，只需改base_url。没有特殊依赖，一个requests就够了。
- chat（deepseek-chat）：通用对话，速度快，适合聊天、简单问答、代码生成。日常首选，性价比最高。 - reasoner（deepseek-reasoner）：擅长逻辑推理、数学、复杂分析。比如要求“列出三步推理过程”时用这个。效果接近顶级模型，但响应稍慢。 - v4-flash（deepseek-v4-flash）：极速版本，延迟低，适合实时交互（比如打字同时流式输出）。精度略低于标准版，但日常够用。 - v4-pro（deepseek-v4-pro）：旗舰版，精度最高，适合对答案质量要求严苛的场景（比如合同审核、论文润色）。成本也最高。
起步建议先用chat，感觉不够用再换flash，需要深度推理时切reasoner。pro留给利润高的业务。
api_key = os.getenv("DEEPSEEK_API_KEY") # 从环境变量读取 url = "https://api.deepseek.com/chat/completions"
payload = { "model": "deepseek-chat", # 换成你选好的版本 "messages": [ {"role": "user", "content": "解释一下什么是CAP定理"} ], "temperature": 0.7 }
headers = { "Authorization": f"Bearer {api_key}", "Content-Type": "application/json" }
resp = requests.post(url, json=payload, headers=headers)
data = resp.json()
print(data["choices"][0]["message"]["content"])
`
如果你想用OpenAI的官方SDK，先安装pip install openai，然后：
client = OpenAI( api_key=os.getenv("DEEPSEEK_API_KEY"), base_url="https://api.deepseek.com/v1" # 注意这个路径 )
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "深圳今天天气怎样？"}]
)
print(response.choices[0].message.content)
`
两种方式都行，推荐第二种，代码更简洁，且支持流式输出。
版本选择没有银弹：chat是万金油，reasoner专攻难题，flash抢速度，pro拼质量。建议初期用chat跑通流程，上线后按实际效果和预算灵活切换。另外注意token计费，不同版本单价不同，官方价格表一目了然。最后一个小技巧：先在控制台用Playground测试提示词，调好了再搬到代码里，能省不少debug时间。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。