DeepSeek API 快速上手：Python、Node.js 与环境变量配置

10 月 18 日补充：当前 deepseek-flash 服务已对应 Flash-1017；见模型更新。原请求示例继续使用该别名，升级行为请按自己的样本核对。

DeepSeek 提供与 OpenAI SDK 兼容的接口。你需要先在开放平台创建 API Key，再通过环境变量注入应用。切勿把密钥写进前端代码、Git 仓库或公开截图。

一、准备环境变量

# macOS / Linux 当前终端会话
export DEEPSEEK_API_KEY='你的密钥'

正式部署时应使用托管平台的 Secret 管理功能，并为开发、测试和生产环境使用不同密钥。

二、Python 示例

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ['DEEPSEEK_API_KEY'],
    base_url='https://api.deepseek.com',
)

response = client.chat.completions.create(
    model='deepseek-flash',
    messages=[
        {'role': 'system', 'content': '你是一个简洁的中文助手。'},
        {'role': 'user', 'content': '用三点解释什么是向量数据库。'},
    ],
    extra_body={'thinking': {'type': 'disabled'}},
)

print(response.choices[0].message.content)

三、Node.js 示例

import OpenAI from 'openai';

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

const response = await client.chat.completions.create({
  model: 'deepseek-flash',
  messages: [
    { role: 'system', content: '你是一个简洁的中文助手。' },
    { role: 'user', content: '用三点解释什么是向量数据库。' },
  ],
  thinking: { type: 'disabled' },
});

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

四、从示例走向生产

• 设置合理的连接和响应超时，避免请求无限等待。
• 记录请求 ID、模型名、耗时和 Token 用量，但不要记录密钥或敏感原文。
• 只对可重试错误采用指数退避，并限制最大重试次数。
• 对模型输出做业务校验，不把自然语言结果直接当作可信指令执行。