Appearance
DeepSeek API 提供四个核心 REST 端点:对话补全、文本补全(FIM)、模型列表、账户余额查询。所有接口使用 Bearer Token 认证,完全兼容 OpenAI SDK,只需替换 baseURL 和 apiKey 即可使用。
DeepSeek API 接口总览
Base URL: https://api.deepseek.com
Beta Base URL: https://api.deepseek.com/beta(FIM 补全、对话前缀续写需要此端点)
认证: Bearer Token(HTTP Authorization 头)
Authorization: Bearer <your-api-key>端点列表
| 方法 | 端点 | 说明 | 参考 |
|---|---|---|---|
| POST | /chat/completions | 对话补全(主要接口) | 详细文档 |
| POST | /completions | 文本补全 / FIM 补全(Beta) | 详细文档 |
| GET | /models | 列出可用模型 | 详细文档 |
| GET | /user/balance | 查询账户余额 | 详细文档 |
快速接入
DeepSeek API 与 OpenAI SDK 完全兼容,无需额外安装包:
typescript
import OpenAI from "openai"; // 直接用 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: "user", content: "Hello" }],
});python
from openai import OpenAI # 直接用 openai 包
client = OpenAI(
api_key="<your api key>",
base_url="https://api.deepseek.com",
)当前可用模型
| 模型 ID | 说明 |
|---|---|
deepseek-v4-pro | 最强模型,支持思考模式,1M 上下文 |
deepseek-v4-flash | 快速版,成本约为 pro 的 1/10 |
deepseek-chat | 临时别名,指向 v4-flash 非思考模式,2026-07-24 停用 |
deepseek-reasoner | 临时别名,指向 v4-flash 思考模式,2026-07-24 停用 |
错误处理
所有接口遵循相同的错误格式,参见 错误码说明。
常见问题
Q: DeepSeek API 和 OpenAI API 有什么区别?
A: 接口格式完全兼容,主要区别在于:DeepSeek 新增了 thinking 参数(思考模式)、prefix 消息类型(对话前缀续写)、reasoning_content 响应字段。如果不用这些扩展特性,OpenAI SDK 可以零修改接入。
Q: 有没有 Anthropic SDK 的兼容端点?
A: 有,https://api.deepseek.com/anthropic 提供 Anthropic Messages API 格式的兼容层,主要用于将 Claude Code 等工具接入 DeepSeek。详见 Anthropic 兼容模式。