面向开发者的 DeepSeek API 使用说明，覆盖 deepseek-chat、deepseek-reasoner、Thinking、Tool Calls 与 JSON 输出。

DeepSeek API 工作流

这部分主要面向开发者。
如果你只是日常对话体验，可以先看网页端与提示词。
如果你要接入业务系统，下面这些概念必须先搞清楚。

1. 先理解三个层次

网站与聊天入口

适合人工使用和快速试验。

API 文档

适合查看参数、返回结构、工具调用方式和示例代码。

API 地址

真正发请求的地址是 https://api.deepseek.com。
文档中出现的 /v1 更多是兼容路径，不等于模型版本号。

2. 常见模型与模式

根据官方文档，当前开发者最常接触的是：

deepseek-chat
deepseek-reasoner

此外，部分能力可以通过 thinking 参数切换，而不只是靠模型名区分。

3. 最小调用示例

下面是一个 OpenAI 兼容方式的简化示例：

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-chat',
  messages: [
    { role: 'system', content: '你是一个结构化输出助手。' },
    { role: 'user', content: '把这段内容总结成 5 个要点。' }
  ]
});

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