👁 565 次阅读
一、为什么选择 DeepSeek API
DeepSeek 是国内最受关注的大模型厂商之一，其 API 最大的特点是兼容 OpenAI 与 Anthropic 两种接口格式：官方文档明确指出，只要修改 base_url 配置，就能直接复用 OpenAI/Anthropic 官方 SDK 以及大量兼容软件，几乎不需要改动现有代码（据 DeepSeek API 官方文档 api-docs.deepseek.com）。这意味着你既可以用熟悉的 OpenAI Python 库，也可以把 DeepSeek 接入 Claude Code、GitHub Copilot、OpenCode 等 AI 编程工具当作后端模型使用。
本教程基于 DeepSeek 官方 API 文档（2026 年 8 月 6 日核实），带你从零开始：申请 API Key → 了解模型与价格 → 用 Python/curl/Node.js 发起调用 → 接入主流 AI 编程工具，最后分享思考模式、JSON 输出、上下文缓存等进阶技巧。
二、第一步：注册平台并申请 API Key
调用 DeepSeek API 前需要先申请 API Key。流程如下：
- 打开 DeepSeek 开放平台（platform.deepseek.com），注册/登录账号；
- 进入控制台，在 API Keys 页面点击创建新 Key，保存好生成的密钥（只显示一次）；
- 在”充值/余额”页面按需充值，或者领取平台赠送的额度；官方说明计费按 token 数扣除，优先使用赠送余额。
安全提醒：API Key 等同于资金凭证，务必存放在环境变量或密钥管理服务中，不要硬编码在代码里、不要提交到 GitHub。下文示例统一使用环境变量 DEEPSEEK_API_KEY 读取。
三、第二步：了解模型与价格（2026 年 8 月官方数据）
DeepSeek API 目前提供两个模型：deepseek-v4-flash（当前版本为 DeepSeek-V4-Flash-0731，调用方式不变，直接用模型名即可访问最新版）和 deepseek-v4-pro。两者均支持 OpenAI 格式（base_url 为 https://api.deepseek.com）与 Anthropic 格式（base_url 为 https://api.deepseek.com/anthropic
模型对比表（据 api-docs.deepseek.com 官方定价页）
| 项目 | deepseek-v4-flash | deepseek-v4-pro |
|---|---|---|
| 当前版本 | DeepSeek-V4-Flash-0731 | DeepSeek-V4-Pro |
| 上下文长度 | 1M（最大输出 384K） | |
| 输入价格（缓存命中） | $0.0028 / 百万 token | $0.003625 / 百万 token |
| 输入价格（缓存未命中） | $0.14 / 百万 token | $0.435 / 百万 token |
| 输出价格 | $0.28 / 百万 token | $0.87 / 百万 token |
| 并发限制 | 2500 | 500 |
| JSON 输出 / Tool Calls | 均支持 | |
| Responses API | 支持 | 暂不支持（官方称 2026 年 8 月初将支持） |
选型建议：日常对话、批量处理、成本敏感场景选 flash；需要更强推理能力、复杂任务选 pro。价格单位为每百万 token，官方还预告了高峰/低谷分时定价：高峰时段（北京时间每日 9:00-12:00 与 14:00-18:00）价格为常规价格的 2 倍，生效日期以官方公告为准。
四、第三步：Python 发起第一次调用（推荐）
DeepSeek 官方推荐使用 OpenAI SDK，兼容性最好。安装与调用如下（示例来自官方文档）：
1. 安装 OpenAI SDK：
pip3 install openai2. 编写调用代码（非流式）：
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": "Hello"},
],
stream=False,
reasoning_effort="high",
extra_body={"thinking": {"type": "enabled"}}
)
print(response.choices[0].message.content)运行前先设置环境变量：export DEEPSEEK_API_KEY=你的Key。官方文档还支持 stream=true 开启流式输出，适合做打字机效果或长文本生成。
五、第四步：用 curl 快速测试（无需装任何依赖）
想最快验证 Key 是否可用，直接用 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": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"}
],
"thinking": {"type": "enabled"},
"reasoning_effort": "high",
"stream": false
}'六、第五步：Node.js 调用
前端或服务端是 JavaScript 生态的，安装 openai 包后同样只需改 baseURL：
// npm install openai
import OpenAI from "openai";
const openai = new OpenAI({
baseURL: "https://api.deepseek.com",
apiKey: process.env.DEEPSEEK_API_KEY,
});
async function main() {
const completion = await openai.chat.completions.create({
messages: [{ role: "system", content: "You are a helpful assistant." }],
model: "deepseek-v4-pro",
thinking: {"type": "enabled"},
reasoning_effort: "high",
stream: false,
});
console.log(completion.choices[0].message.content);
}
main();七、进阶玩法：把 DeepSeek 接入 Claude Code / GitHub Copilot / OpenCode
官方文档专门提供了 Agent Integrations 指南：DeepSeek API 已被大量主流 AI 编程工具支持，如果你在用 Claude Code、GitHub Copilot 或 OpenCode，无需写任何代码，只需在工具配置里把模型后端切换为 DeepSeek 即可。典型做法是在工具的环境配置/模型配置中填入：
Base URL: https://api.deepseek.com
API Key: 你的 DEEPSEEK_API_KEY
模型: deepseek-v4-flash 或 deepseek-v4-pro这样你就能用上 1M 超长上下文、最高 384K 输出的模型来辅助编程，同时享受比许多海外旗舰 API 更低的成本。
八、进阶技巧：思考模式、JSON 输出与上下文缓存省钱
1. 思考模式（Thinking Mode）
官方文档说明：deepseek-v4-flash 与 v4-pro 都支持非思考与思考（默认）两种模式。通过请求参数 thinking: {"type": "enabled"} 开启思考模式，配合 reasoning_effort（如 high）调节推理深度。复杂逻辑、代码生成、数学推理建议开启；简单问答可关闭以降低延迟。
2. JSON 输出与 Tool Calls
两个模型均支持 JSON Output 与 Tool Calls（函数调用），适合做结构化数据抽取、Agent 工具编排。官方还有 Chat Prefix Completion（前缀补全，Beta）与 FIM Completion（代码补全，Beta，仅限非思考模式）等高级接口。
3. 上下文缓存：成本可降 50 倍
这是最实用的省钱技巧：官方定价中，缓存命中时的输入价格比未命中便宜约 50 倍（flash 为 $0.0028 vs $0.14）。如果你的应用反复传入相同的系统提示词、知识库上下文，尽量保持前缀稳定，让命中缓存，能显著降低长期成本。
九、注意事项与常见问题
- 计费规则：费用 = token 数 × 单价，直接从余额扣除，优先扣赠送余额（据官方文档）。
- 限流与并发：flash 并发上限 2500，pro 为 500，批量任务注意控制并发，避免被限流（官方 Rate Limit 文档）。
- 分时定价预告：官方即将实行高峰/低谷定价，高峰时段（北京 9:00-12:00、14:00-18:00）价格翻倍，重任务可安排在低谷时段。
- Key 安全：Key 泄露会被盗刷，建议定期轮换，并在平台后台关注用量。
- 版本更新：deepseek-v4-flash 已更新至 V4-Flash-0731，调用方式不变；价格与版本可能调整，以官方文档为准。
十、总结
DeepSeek API 的优势可以概括为三点：接口兼容（OpenAI/Anthropic 双格式）、成本低（flash 输出仅 $0.28/百万 token，缓存命中输入低至 $0.0028）、生态好（可直接接入 Claude Code、GitHub Copilot、OpenCode 等工具）。从申请 Key 到跑通第一个应用，全程只需几分钟；再结合思考模式、JSON 输出与上下文缓存，足以支撑个人项目到生产级应用的各类场景。
本文所有参数、价格与功能均核实自 DeepSeek 官方 API 文档（api-docs.deepseek.com，2026 年 8 月 6 日访问）。实际价格与版本如有变动，请以官方页面为准。