OpenAI迁移到DeepSeekAPI教程

OpenAI用户无需重写代码或更换SDK，只需三处关键修改——替换API密钥、调整base_url为https://api.deepseek.com（切勿加/v1）、改用deepseek-chat等官方模型名，即可无缝迁移到DeepSeek API；其完全兼容OpenAI v1接口规范，流式输出、system角色、temperature等参数原样保留，但需注意delta.content可能为空、非标参数需通过extra_body传递，以及网关调试时务必设置Accept-Encoding: identity头以避免流式响应解析失败——一次迁移，零逻辑重构，即刻享受DeepSeek更优的中文能力与推理性能。

直接改三处就能跑通：api_key、base_url、model。其余代码完全不动，包括流式输出、system 角色、temperature 等参数都原样保留。

改 base_url 和 api_key 就够了

DeepSeek 官方 API 完全兼容 OpenAI v1 接口规范，不需要重装 SDK 或改调用逻辑。 你原来用的是 openai Python 包或 openai Node.js SDK？那根本不用换包，只替换初始化参数：

• api_key 改成你在 deepseek.com 申请的 key（不是 OpenAI 的 sk- 开头）
• base_url 改成 https://api.deepseek.com
• 其他如 timeout、http_client、default_headers 全部照旧

常见错误：把 base_url 写成 https://api.deepseek.com/v1 —— 实际上官方 endpoint 已带 /v1，多加会 404。

model 名称不能照抄 OpenAI 的

DeepSeek 不认 gpt-4o、gpt-3.5-turbo 这类名字，必须换成它自己的模型标识符：

• deepseek-chat：通用对话模型（免费，适合大多数场景）
• deepseek-r1：2026 年 1 月发布的推理增强版，中文强、延迟低
• deepseek-v4-pro：最新版，支持 enable_thinking 参数开启推理链

注意：deepseek-r1 和 deepseek-v4-pro 在部分网关（如 Higress）里可能需显式启用，直连官方 API 则开箱即用。

流式响应和非标准参数要小心

流式输出（stream=True）完全兼容，但解析方式有细微差别：

• DeepSeek 的 delta.content 可能为空字符串（尤其在开头），建议加空值判断：chunk.choices[0]?.delta?.content or ""
• 非 OpenAI 标准参数（比如 enable_thinking、reasoning_effort）不能直接传顶层，得走 extra_body（Python）或顶层对象（Node.js）

例如 Python 中启用思考模式：

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[{"role": "user", "content": "解方程"}],
    extra_body={"enable_thinking": True}
)

本地网关调试时别漏掉 default_headers

如果你用 Higress 或自建网关（比如 http://localhost:8080/v1），常遇到 406 Not Acceptable 或流式卡住：

• 必须加 default_headers={"Accept-Encoding": "identity"}，否则某些网关会自动 gzip 压缩流式 chunk，SDK 解析失败
• 网关配置里模型名写 deepseek-chat，但后端 provider 要正确指向 DeepSeek 官方 endpoint，否则 fallback 会静默失败

真正容易被忽略的点是：网关层的模型映射和客户端传的 model 字符串必须严格一致，大小写、中划线、是否带 -chat 后缀，一个字符不对就 404。

理论要掌握，实操不能落！以上关于《OpenAI迁移到DeepSeekAPI教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！