上个月给项目接入 AI 对话功能，面对 DeepSeek 四个版本（chat、reasoner、v4-flash、v4-pro）直接蒙圈。文档里写了一大堆参数，但哪个适合我的场景？按默认选 chat 试了试，结果推理类问题答得稀烂；换成 v4-pro 确实强，但账单数字跳得比心跳还快。最坑的是 v4-flash 调用时参数名和 chat 不一样，调试半小时才发现。如果你也遇到过类似问题，这篇指南能帮你省下至少两小时试错时间。
开始之前，确保手头有这三个东西：一个 DeepSeek 账号、一个 API Key、以及任意能发 HTTP 请求的工具（curl 或 Python 都行）。注册很简单，去官网用邮箱或手机号就能搞定，不需要审核。拿到 API Key 后记得存成环境变量，别硬编码在代码里——上次我把 key 写到前端代码里，第二天就被人刷爆了额度。另外建议先看下官网的“模型说明”，不同版本的输入输出限制、价格、上下文长度都不一样，我踩过的坑是你最好的路标。
第一步：分清四个版本，按场景选
- chat：默认对话模型，适合日常闲聊、简单的问答和内容摘要。速度和成本都最均衡，个人开发者起步首选。缺点是你别指望它做复杂数学或逻辑推理。 - reasoner：专门强化推理能力，数学题、代码 Bug 分析、逻辑推导表现明显更好。价格是 chat 的 2 倍，但如果你做教育类或技术辅助工具，这笔钱值得花。 - v4-flash：响应速度最快的版本，牺牲一定质量换延迟。适合对实时性要求高的场景（比如聊天机器人），但别让它写技术文章或生成代码，幻觉率偏高。 - v4-pro：顶配模型，几乎无短板，同样价格也最贵。我只有在正式产品上线前做性能测试时才会用，平时开发调 bug 舍不得开。
把四个版本看作工具：起螺丝用螺丝刀，打墙用电钻。做 demo 时从 chat 开始，发现不够用再升级 reasoner 或 pro，v4-flash 作为降级备用。
第二步：申请 API Key
登录 DeepSeek 后台，左侧菜单找到“API Keys”，点“创建 API Key”。输入一个名字（建议按项目命名，方便后期清理），复制生成的密钥。注意：这个密钥只在创建时显示一次，记得立刻保存到本地密钥文件或密码管理器里。我习惯在项目根目录建一个 .env 文件，写入 DEEPSEEK_API_KEY=sk-xxxx，然后添加到 .gitignore。
第三步：配置并发送第一个请求
推荐用 Python 的 requests 库，代码简洁。以下是一个连接 chat 版本的示例：
url = "https://api.deepseek.com/v1/chat/completions"
headers = {
"Authorization": f"Bearer {os.environ['DEEPSEEK_API_KEY']}",
"Content-Type": "application/json"
}
payload = {
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好，请用一句话解释什么是API"}],
"temperature": 0.7
}
response = requests.post(url, json=payload, headers=headers)
print(response.json()["choices"][0]["message"]["content"])
`
换其他版本只需要改 model 字段的值：deepseek-reasoner、deepseek-v4-flash、deepseek-v4-pro。注意 reasoner 模型对 temperature 和 top_p 参数更敏感，建议保持默认 0.5。如果遇到 401 错误，八成是 Key 没传对或者没加 Bearer 前缀；遇到 429 就是超速了，加个 time.sleep(1) 再试。
总结一下：选版本时，Chat 打底、Flash 救急、Reasoner 做推理、Pro 提质量。申请 Key 后测试时先用免费额度（DeepSeek 新号通常有 5 元体验金）。代码就那一套，换模型名就行。个人开发者建议从 chat 版本开始，跑通第一个请求后，再用不同场景的提示词测试其他版本，看哪个性价比高。最后提醒一句：不要在生产环境直接暴露你的 API Key，用后端中转，或者至少限制 IP 白名单。
如果你也想试试一个Key调多个模型的方便，可以看看充站——¥50起步，额度永久有效，用支付宝/微信就能付款。