5分钟：从 GPT API 迁移到 DeepSeek

2026-06-11 · 5 分钟阅读

    好消息：DeepSeek API 完全兼容 OpenAI SDK。你用 Python openai 包或者 Node.js openai 包写的代码，一行逻辑代码都不用改，只换 URL + Key 就行。
  

一、Python 迁移（30秒）

原来的代码：

from openai import OpenAI

client = OpenAI(api_key="sk-your-openai-key")
response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

改成这样：

from openai import OpenAI

client = OpenAI(
    api_key="sk-your-deepseek-key",           # ← 换 key
    base_url="https://api.deepseek.com/v1"    # ← 加这行
)
response = client.chat.completions.create(
    model="deepseek-v4-flash",                # ← 换模型名
    messages=[{"role": "user", "content": "Hello!"}]
)

改了三处，逻辑不变。就这么简单。

二、Node.js 迁移（30秒）

原来的代码：

import OpenAI from "openai";

const client = new OpenAI({ apiKey: "sk-your-openai-key" });
const r = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello!" }]
});

改成这样：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-your-deepseek-key",
  baseURL: "https://api.deepseek.com/v1"
});
const r = await client.chat.completions.create({
  model: "deepseek-v4-flash",
  messages: [{ role: "user", content: "Hello!" }]
});

三、Claude Code 配置（1分钟）

如果你用 Claude Code，配置 settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-deepseek-key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic"
  }
}

⚠️ 注意 Base URL 要加 /anthropic 后缀，协议不同。

四、常见坑点

坑 1：response_format 参数

DeepSeek 对一些冷门参数（如 response_format: "json_schema"）的支持不如 GPT 完整。建议用 Prompt 引导 JSON 输出，而不是依赖参数。

坑 2：max_tokens 默认值不同

GPT-4o 默认 max_tokens 很大，DeepSeek 需要显式指定。不加可能收到截断的回复。

# 建议始终显式指定
completion = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[...],
    max_tokens=4096  # ← 加这行
)

坑 3：多模态需要独立处理

DeepSeek V4 支持图片输入，但格式与 GPT 略有不同。如果大量使用图片理解，建议保留一个 GPT 的后备节点。

坑 4：API Key 余额查询

DeepSeek 控制台查余额：https://platform.deepseek.com/usage
没有 /usage API 端点，需要登录网页查看。

五、渐进式迁移策略

不推荐一次性全切。建议三步走：

第一周：把非关键路径（如翻译、摘要）切到 DeepSeek V4 Flash
第二周：把代码生成、推理类切到 DeepSeek V4 Pro
第三周：把多模态留在 GPT，其他全切 DeepSeek

用 API Router 同时连接多个模型，按任务类型自动分发，一行代码都不用改。

← 回首页