DeepSeek 开放平台提供 deepseek-v4-pro 和 deepseek-v4-flash 两个模型，均支持 1M 超长上下文。API 完全兼容 OpenAI SDK 格式，只需替换 baseURL 和 api_key 即可零成本迁移。本指南帮助开发者从申请 Key 到第一次成功调用，完整走完接入流程。

DeepSeek API 中文文档

DeepSeek API 基于标准 OpenAI 格式，也支持 Anthropic SDK 格式，方便已有项目快速接入。

快速开始

第一步：申请 API Key

前往 DeepSeek 开放平台 注册并创建 API Key。

第二步：调用 API

DeepSeek API 兼容 OpenAI SDK，只需改两行代码：

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.deepseek.com",  // 改这里
  apiKey: process.env.DEEPSEEK_API_KEY, // 改这里
});

const response = await client.chat.completions.create({
  model: "deepseek-v4-pro",
  messages: [
    { role: "system", content: "You are a helpful assistant." },
    { role: "user", content: "你好！" },
  ],
  stream: false,
});

console.log(response.choices[0].message.content);

Python 版本：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com",
)

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "你好！"},
    ],
    stream=False,
)
print(response.choices[0].message.content)

curl：

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "你好"}],
    "stream": false
  }'

模型选择

模型	特点	适用场景
deepseek-v4-pro	最强性能，支持思考模式	复杂推理、代码生成、Agent
deepseek-v4-flash	极低成本（输入 1元/M token）	高并发、简单问答、预处理

两个模型均支持：

• 1M 上下文长度（业界最长之一）
• 384K 最大输出
• JSON Output、Tool Calls、FIM 补全
• 上下文硬盘缓存（KV Cache，反复调用大幅降价）

注意：deepseek-chat（对应 V3）和 deepseek-reasoner（对应 R1）将于 2026/07/24 弃用，新项目请直接使用 deepseek-v4-pro / deepseek-v4-flash。

与 OpenAI / Claude 的对比

	DeepSeek	OpenAI GPT-4o	Claude 3.5 Sonnet
最大上下文	1M	128K	200K
API 兼容格式	OpenAI + Anthropic	OpenAI	Anthropic
国内访问	✅ 无需代理	❌ 需代理	❌ 需代理
价格（输入/M）	1元（flash）/ 3元（pro）	~30元	~20元

常见问题

Q: DeepSeek API 和 OpenAI API 的接口完全一样吗？

A: 核心 Chat Completions 接口基本一致，部分参数（如 thinking、reasoning_effort）是 DeepSeek 独有扩展。已有 OpenAI 项目只需改 baseURL 和 apiKey，几分钟内可完成迁移。

Q: 国内开发者能直接访问 DeepSeek API 吗？

A: 可以，api.deepseek.com 在中国大陆可直接访问，无需代理。

Q: deepseek-chat 和 deepseek-v4-pro 是什么关系？

A: deepseek-chat 是旧版 V3 模型的别名，将于 2026/07/24 弃用。新项目请直接使用 deepseek-v4-pro 或 deepseek-v4-flash。