DeepSeek API 接入与 JSON 输出

通过 API 可以把 DeepSeek 接入自己的应用。这里集中说明 Key 的使用、请求配置与返回内容处理,并提供代码示例供你在自己的环境中验证。

按四步配置接口

  1. 准备账号:访问 打开开发平台 注册,随后进入控制台。
  2. 创建并保存 API Key:在控制台生成密钥,通常仅创建时完整展示一次。保存时注意安全,一旦疑似泄露,立即撤销旧密钥并创建新密钥。
  3. 配置接口地址:base_url 使用官方文档中的 API 地址,路径为 /v1。可选模型名称是 deepseek-chat、deepseek-reasoning,由实际任务决定。
  4. 请求验证:先发一句简短内容,检查 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 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,服务端会以增量事件返回内容,客户端负责按事件拼接。若希望对话逐字呈现,可使用流式;批量处理场景通常无需启用。