📅 2026年7月24日更新 · 📖 阅读约12分钟

DeepSeek API 完整使用教程
从注册到调用,一篇搞定

📑 目录

  1. DeepSeek API 是什么?
  2. DeepSeek 模型家族一览
  3. 注册并获取 API Key
  4. Python 调用示例
  5. Node.js 调用示例
  6. cURL 调用示例
  7. 模型选择指南
  8. 使用技巧与最佳实践
  9. 常见问题 FAQ
  10. 更简单的方案:统一网关

1. DeepSeek API 是什么?

DeepSeek API 是深度求索(DeepSeek)提供的大语言模型接口服务。通过 API,开发者可以在自己的应用中调用 DeepSeek 的 AI 模型,实现对话、代码生成、文本分析等功能。

DeepSeek API 兼容 OpenAI 协议,这意味着如果你已经在用 OpenAI SDK,只需修改一行代码就能切换到 DeepSeek。

💡 核心优势

2. DeepSeek 模型家族一览

模型类型上下文输入价格适用场景
deepseek-chat (V3)通用对话64K$0.27/M tokens日常对话、内容生成
deepseek-reasoner (R1)推理模型64K$0.55/M tokens数学、逻辑推理、代码
DeepSeek-V4-Flash新一代通用128K$0.14/M tokens高速低成本场景
DeepSeek-V4-Pro新一代旗舰128K$0.50/M tokens复杂任务、高质量输出

3. 注册并获取 API Key

方式一:官方注册

  1. 访问 platform.deepseek.com
  2. 使用手机号或邮箱注册
  3. 完成实名认证
  4. 进入「API Keys」页面
  5. 点击「创建 API Key」
  6. 复制并妥善保存你的 Key
⚠️ 注意:官方注册可能需要实名认证,且 API 额度需要预充值。如果你需要更便捷的接入方式,可以看最后的统一网关方案

方式二:通过统一网关获取(推荐新手)

如果你不想分别注册多个平台的账号,可以通过统一 API 网关一次性获取所有中国大模型的访问权限:

  1. 访问 AI Token 售前助手 咨询
  2. 选择合适的套餐(¥99/月起)
  3. 扫码支付,即时获得 API Key
  4. 一个 Key 调用 38+ 模型,包括 DeepSeek 全系列

4. Python 调用示例

安装依赖

pip install openai

基础对话

from openai import OpenAI

# 初始化客户端
client = OpenAI(
    base_url="https://api.deepseek.com",
    api_key="sk-your-api-key-here"
)

# 发送对话请求
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "用Python写一个快速排序算法"}
    ],
    temperature=0.7,
    max_tokens=2048
)

# 打印结果
print(response.choices[0].message.content)

流式输出

from openai import OpenAI

client = OpenAI(
    base_url="https://api.deepseek.com",
    api_key="sk-your-api-key-here"
)

# 流式输出,逐字显示
stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一首关于编程的诗"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

使用 DeepSeek-R1 推理模型

response = client.chat.completions.create(
    model="deepseek-reasoner",  # R1 推理模型
    messages=[{
        "role": "user",
        "content": "证明√2是无理数"
    }]
)

# R1 会输出推理过程
print(response.choices[0].message.content)

5. Node.js 调用示例

// npm install openai
import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://api.deepseek.com',
  apiKey: 'sk-your-api-key-here',
});

const response = await client.chat.completions.create({
  model: 'deepseek-chat',
  messages: [
    { role: 'user', content: '解释量子计算的基本原理' }
  ],
});

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

6. cURL 调用示例

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key-here" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

7. 模型选择指南

场景推荐模型理由
日常对话/客服deepseek-chat (V3)性价比高,响应快
数学/逻辑推理deepseek-reasoner (R1)专精推理,思维链透明
批量文本处理DeepSeek-V4-Flash最低价格,最快速度
高质量内容创作DeepSeek-V4-Pro最强效果,复杂任务
代码生成/审查deepseek-chat / R1代码能力强,R1更适合复杂debug

8. 使用技巧与最佳实践

设置合理的 temperature

善用 System Prompt

messages = [
    {"role": "system", "content": """你是一个专业的Python开发者。
规则:
1. 代码必须有注释
2. 遵循PEP 8规范
3. 优先使用标准库
4. 给出完整可运行的代码"""},
    {"role": "user", "content": "写一个web爬虫"}
]

控制 Token 消耗

错误处理

import openai

try:
    response = client.chat.completions.create(...)
except openai.RateLimitError:
    print("请求频率超限,请稍后重试")
except openai.AuthenticationError:
    print("API Key 无效或已过期")
except openai.APIError as e:
    print(f"API 错误: {e}")

9. 常见问题 FAQ

DeepSeek API 的价格是多少?

DeepSeek-V3 输入 $0.27/百万 token,输出 $1.10/百万 token。DeepSeek-R1 输入 $0.55/百万 token,输出 $2.19/百万 token。相比 GPT-4o 便宜约 100 倍。

DeepSeek API 有免费额度吗?

新注册用户通常会获得少量免费额度。具体额度以官方最新政策为准。也可以通过第三方统一网关获取体验额度。

DeepSeek 和 ChatGPT 有什么区别?

DeepSeek 是中国开发的大模型,中文能力优秀,价格极低。DeepSeek-V3 在多数基准测试中与 GPT-4o 相当,某些数学和代码任务甚至更好。DeepSeek-R1 在推理任务上表现出色。

API 调用频率有限制吗?

取决于你的账户等级。免费版有较低的 RPM(每分钟请求数)限制,付费版限制更宽松。建议实现重试机制和请求队列。

如何同时使用多个中国大模型?

可以使用统一 API 网关(如 AI Token),一个 API Key 同时访问 DeepSeek、Qwen、GLM、Kimi 等 38+ 模型,无需分别注册和充值。

海外开发者能使用 DeepSeek API 吗?

可以。DeepSeek API 支持全球访问。如果遇到网络问题,可以通过 CDN 加速节点或统一网关来优化访问速度。

10. 更简单的方案:统一 API 网关

如果你不想分别注册多个平台的账号、管理多个 API Key,可以使用统一 API 网关服务:

🚀 AI Token — 一个 Key 调用 38+ 中国大模型

开始使用 AI Token

一个 API Key 解锁 38+ 中国顶级大模型

¥99/月 立即订阅 → ¥399/月 团队版 →

💬 不确定选哪个?免费咨询 AI 助手

相关资源

🚀 38+中国大模型API · ¥99/月起 立即订阅 → 💬 免费咨询

📚 Related Articles

DeepSeek vs OpenAI: Which Should You Choose?
Compare performance, pricing, and use cases
The 10 Cheapest LLM APIs in 2026
Find the most cost-effective models for your budget
The Complete Guide to API Relay Services
Learn how API gateways save you money