DeepSeek API 接入与 JSON 输出
通过 API 可以把 DeepSeek 接入自己的应用。这里集中说明 Key 的使用、请求配置与返回内容处理,并提供代码示例供你在自己的环境中验证。
按四步配置接口
- 准备账号:访问 打开开发平台 注册,随后进入控制台。
- 创建并保存 API Key:在控制台生成密钥,通常仅创建时完整展示一次。保存时注意安全,一旦疑似泄露,立即撤销旧密钥并创建新密钥。
- 配置接口地址:base_url 使用官方文档中的 API 地址,路径为
/v1。可选模型名称是deepseek-chat、deepseek-reasoning,由实际任务决定。 - 请求验证:先发一句简短内容,检查 assistant 是否正常响应,之后加入业务流程。
最小调用示例
curl
先把密钥配置到环境变量,减少命令历史暴露密钥的机会:
export DEEPSEEK_API_KEY="sk-你的密钥"
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DEEPSEEK_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": "你是一个严谨的技术助理。"},
{"role": "user", "content": "用三句话解释什么是 API。"}
],
"stream": false
}'读取 choices[0].message.content 可取得模型回答。请求的 token 用量由 usage 字段给出。
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-chat",
messages=[
{"role": "system", "content": "你是一个严谨的技术助理。"},
{"role": "user", "content": "用三句话解释什么是 API。"},
],
temperature=0.3,
max_tokens=1024,
)
print(response.choices[0].message.content)
print(response.usage)示例使用兼容的 Python SDK,无需另找专用依赖。记得将 base_url 设置为 DeepSeek 对应地址。
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.DEEPSEEK_API_KEY,
baseURL: "https://api.deepseek.com",
});
const stream = await client.chat.completions.create({
model: "deepseek-reasoning",
messages: [{ role: "user", content: "解释一下什么是流式输出。" }],
stream: true,
});
for await (const chunk of stream) {
process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}从流式到结构化结果
流式响应:将 stream 设为 true,服务端就会逐段发送增量事件,前端拼接后呈现逐字输出。是否开启取决于用途:对话前端常用,批量处理不必强制启用。
结构化输出:程序要直接使用回答时,可开启 JSON 对象响应格式。还需用系统提示约定字段定义、数据类型及层级关系:
response = client.chat.completions.create(
model="deepseek-chat",
messages=[
{"role": "system", "content": "仅输出 JSON,字段为 city、population、tags(字符串数组)。"},
{"role": "user", "content": "杭州的人口规模和标签。"},
],
response_format={"type": "json_object"},
)
import json
data = json.loads(response.choices[0].message.content)
print(data["city"], data["tags"])返回后先校验结构,必要时重试或修补,防止额外解释文字造成解析失败。实现细节请参考 JSON 及函数调用操作。
调用异常的处理方法
| 异常情况 | 常见诱因 | 建议处理 |
|---|---|---|
| 内容缺失或被截断 | 输出长度限制过小、提示词过长 | 调整 max_tokens,压缩对话历史,必要时分轮汇总 |
| 回答结构未达预期 | 未约定格式或缺少样例 | 先说明字段与 JSON 示例,再开启 JSON 模式检查结构 |
| API 连接超时 | 网络连接问题或服务端高负载 | 调整请求超时与重试,批处理采用较低并发 |
| 401,身份校验失败 | 未提供鉴权头、复制了空白字符、密钥已撤销 | 核对请求是否使用 Bearer 密钥 形式,读取环境变量时检查多余空格 |
| 429,检查频率与额度 | 余额不足或并发、请求频率偏高 | 检查余额、速率上限后进行退避重试 |
接下来配置什么
- 查看 DeepSeek 模型用途比较,按用途判断该请求哪种模型。
- 把模型接入业务流程时,请参考 JSON 及函数调用操作。
- API 产品选型还可结合 DeepSeek、ChatGPT、Claude 对照 中的对照。
DeepSeek API 常见解答
接口域名和路径在哪里查看?
接入域名使用官方 API 文档提供的地址,多数客户端将 base_url 指向其 /v1 路径,采用 OpenAI 兼容的请求和响应格式。按用途选择模型名:通用任务用 deepseek-chat,推理任务可用 deepseek-reasoning。
创建 DeepSeek Key 的入口在哪里?
API Key 在开放平台控制台创建,完整值一般只在创建时显示一次。生成后妥善保存;若可能已经泄露,应在控制台撤销并更换。
API 的 401 错误通常因何发生?
401 代表身份验证失败,应检查 Authorization 是否缺失、Key 是否带有多余空格换行,以及密钥是否已撤销。确认请求头为 Bearer 密钥形式,且 Key 来自环境变量而非代码常量。
DeepSeek API 频率受限怎么办?
429 表示请求频率过高或触及速率、额度限制。检查余额和速率限制,使用指数退避重试,不要在循环里高并发发送相同请求。
程序需要 JSON 时应如何提问?
请求设为 JSON 对象响应模式,系统提示中说明字段名称、类型和嵌套,并提供示例 JSON。使用前验证结构,失败可通过一次重试或后续修补处理。
如何开启流式并处理事件?
把流式参数设为 true,服务端会以增量事件返回内容,客户端负责按事件拼接。若希望对话逐字呈现,可使用流式;批量处理场景通常无需启用。