DeepSeek API 接入完全指南：从申请 Key 到搭建自己的 AI 应用

👁 566 次阅读

一、为什么选择 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，几分钟就能跑通第一个 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 openai

2. 编写调用代码（非流式）：

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 更低的成本。

人工智能机器人概念图 — 把 DeepSeek 接入编程工具，实现低成本 AI 辅助开发

八、进阶技巧：思考模式、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 日访问）。实际价格与版本如有变动，请以官方页面为准。