DeepSeek API 地址与调用示例

一次 DeepSeek API 请求需要准备密钥、接口地址、模型名称和消息内容。下文从基础请求展开,再介绍流式响应、JSON 输出以及常见错误的检查方法。

API 接入的四个环节

  1. 注册开放平台账号:打开 进入 API 平台,注册后登录控制台。
  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 可取得模型回答。usage 记录这次调用的 token 使用量。

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 ?? ""); }

处理流式和 JSON 响应

流式响应:将 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 输出、工具调用实践。

根据错误定位问题

错误表现 可能原因 排查方法
429:请求频率或额度限制 请求太快、并发太多或余额不足 指数退避后重试,并检查余额和速率设置
输出为空或内容截断 max_tokens 设置偏小或提示过长 增加 max_tokens 并精简历史,必要时多轮获取后合并
输出格式不符合要求 没有说明格式或给出示例 补齐字段及 JSON 样例,启用 JSON 模式后验证
请求连接超时 网络不稳定或服务繁忙 设置超时和重试上限,批量调用时减少并发
401:鉴权失败 缺少 Authorization、Key 含空白或已被撤销 检查是否采用 Bearer 密钥 格式,并从环境变量取值、清除空白

首次调用之后

问题解答

API 配置问题解答

调用 DeepSeek 应配置哪个地址?

接入域名使用官方 API 文档提供的地址,多数客户端将 base_url 指向其 /v1 路径,采用 OpenAI 兼容的请求和响应格式。deepseek-chat 面向通用任务,deepseek-reasoning 则偏向推理任务。

如何获得 DeepSeek API Key?

API Key 在开放平台控制台创建,完整值一般只在创建时显示一次。应立即安全保存;疑似泄露时,在控制台撤销旧 Key 并创建新 Key。

401 鉴权失败应检查什么?

401 代表身份验证失败,应检查 Authorization 是否缺失、Key 是否带有多余空格换行,以及密钥是否已撤销。Authorization 应采用 Bearer 加密钥的格式,密钥从环境变量读取,不写死在代码中。

429 限制错误如何处理?

429 表示请求频率过高或触及速率、额度限制。可采用指数退避重试,检查控制台余额和限制,并避免循环中高并发重复请求。

如何配置 DeepSeek 的 JSON 输出?

请求设为 JSON 对象响应模式,系统提示中说明字段名称、类型和嵌套,并提供示例 JSON。收到结果后检查结构,必要时重试一次或进行后处理修补。

API 如何逐段返回回答?

把流式参数设为 true,服务端会以增量事件返回内容,客户端负责按事件拼接。这种方式可用于对话界面的逐字显示,批量任务不必开启。