本文手把手带你完成 DeepSeek API 的注册、申请、接入和实战开发，附完整代码示例。

---

为什么选 DeepSeek API？

2024年底，DeepSeek V3 横空出世，以极低的成本打破了大模型价格壁垒：

• 价格：DeepSeek-V3 输入 ¥0.27/百万token，比 GPT-4o 便宜 90%+
• 性能：在代码、数学、推理任务上对标 GPT-4o
• 开源：模型权重开放，可私有化部署
• API 兼容：与 OpenAI API 格式完全兼容，无缝迁移

---

一、注册与获取 API Key

1.1 注册账号

访问 platform.deepseek.com，使用手机号或邮箱注册。

1.2 创建 API Key

1. 登录后点击左侧 API Keys
2. 点击 创建 API Key
3. 输入名称（如 my-project），点击确认
4. 立即复制保存，Key 只显示一次！

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1.3 充值余额

新用户有免费额度，用完需充值。最低充值 ¥10，按实际消耗计费。

---

二、模型选择

模型	适用场景	价格（输入/输出 per 百万token）
deepseek-chat	日常对话、文章生成	¥0.27 / ¥1.10
deepseek-reasoner	复杂推理、数学解题	¥4.0 / ¥16.0

日常开发推荐 deepseek-chat，性价比最高。

---

三、快速接入 —— 三种方式

方式一：curl 直接调用

curl https://api.deepseek.com/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {"role": "user", "content": "你好，介绍一下自己"}
    ],
    "stream": false
  }'

方式二：Node.js 接入

安装依赖：

npm install openai

完整代码：

const OpenAI = require('openai');

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.deepseek.com',
});

async function chat(message) {
  const response = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [
      { role: 'system', content: '你是一个专业的技术助手' },
      { role: 'user', content: message }
    ],
    temperature: 0.7,
    max_tokens: 2048,
  });
  
  return response.choices[0].message.content;
}

// 使用示例
chat('解释一下什么是闭包').then(console.log);

方式三：Python 接入

pip install openai

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.deepseek.com"
)

def chat(message: str) -> str:
    response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[
            {"role": "system", "content": "你是一个专业的技术助手"},
            {"role": "user", "content": message}
        ],
        temperature=0.7,
        max_tokens=2048
    )
    return response.choices[0].message.content

# 使用示例
print(chat("用Python写一个快速排序"))

---

四、实战：搭建一个文章摘要生成器

4.1 功能设计

• 输入：一篇长文本
• 输出：100字摘要 + 3个关键词

4.2 完整代码

const OpenAI = require('openai');

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

async function summarizeArticle(text) {
  const prompt = `请对以下文章进行摘要，要求：
1. 摘要不超过100字
2. 提取3个关键词
3. 输出格式：
   摘要：xxx
   关键词：xxx, xxx, xxx

文章内容：
${text}`;

  const response = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: prompt }],
    temperature: 0.3,  // 摘要任务用低温度，更稳定
  });

  return response.choices[0].message.content;
}

// 测试
const article = `
Vue 3 引入了 Composition API，这是对 Options API 的重大升级。
Composition API 允许开发者将相关逻辑组织在一起，而不是按照
options（data、methods、computed等）分散。这使得代码复用
更加方便，特别是通过自定义 Hook（组合式函数）来提取可复用逻辑。
setup() 函数是 Composition API 的入口点...
`;

summarizeArticle(article).then(result => {
  console.log('=== 摘要结果 ===');
  console.log(result);
});

4.3 运行结果

=== 摘要结果 ===
摘要：Vue 3的Composition API是对Options API的重大升级，通过setup()函数将相关逻辑集中管理，支持自定义Hook提升代码复用性，解决了Options API逻辑分散的问题。
关键词：Composition API, setup函数, 代码复用

---

五、流式输出（Streaming）

大模型默认等全部生成完才返回，用户体验差。开启流式可以边生成边显示：

async function streamChat(message) {
  const stream = await client.chat.completions.create({
    model: 'deepseek-chat',
    messages: [{ role: 'user', content: message }],
    stream: true,  // 开启流式
  });

  for await (const chunk of stream) {
    const content = chunk.choices[0]?.delta?.content || '';
    process.stdout.write(content);  // 实时打印
  }
  console.log('\n--- 输出完成 ---');
}

streamChat('写一首关于程序员的诗');

---

六、成本控制技巧

// 1. 统计 token 消耗
const response = await client.chat.completions.create({ ... });
console.log('消耗 token：', response.usage);
// { prompt_tokens: 50, completion_tokens: 200, total_tokens: 250 }

// 2. 设置 max_tokens 防止超支
const response = await client.chat.completions.create({
  model: 'deepseek-chat',
  messages: [...],
  max_tokens: 500,  // 最多输出 500 个 token
});

// 3. 用 temperature=0 提高一致性，减少重试
// 4. 缓存相同问题的答案，避免重复调用

---

七、常见问题

Q: 报错 AuthenticationError A: 检查 API Key 是否正确，注意不要有多余空格

Q: 报错 InsufficientQuota A: 余额不足，需要充值

Q: 响应很慢 A: 使用流式输出改善体验；也可以试试 deepseek-chat 的缓存命中机制

Q: 能用在生产环境吗？ A: 可以，DeepSeek 提供 99.9% 的 SLA 保障

---

总结

DeepSeek API 是目前性价比最高的大模型 API 之一：

• ✅ OpenAI 兼容，迁移成本极低
• ✅ 价格是 GPT-4o 的 1/10
• ✅ 中文理解能力强
• ✅ 代码生成质量高

无论是个人项目还是商业应用，DeepSeek 都是首选。赶紧试起来！

---

如果本文对你有帮助，点个赞 👍 收藏备用！有问题欢迎评论区交流。