DeepSeek API 地址与调用示例
一次 DeepSeek API 请求需要准备密钥、接口地址、模型名称和消息内容。下文从基础请求展开,再介绍流式响应、JSON 输出以及常见错误的检查方法。
API 接入的四个环节
- 注册开放平台账号:打开 进入 API 平台,注册后登录控制台。
- 创建并保存 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 可取得模型回答。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 密钥 格式,并从环境变量取值、清除空白 |
首次调用之后
- 模型选择可参考 DeepSeek 模型选择参考,再确定接口请求的目标模型。
- 要将调用组成后端流程,可继续查看 JSON 输出、工具调用实践。
- 各家 API 的接入与成本对比,可查看 比较 DeepSeek、ChatGPT 与 Claude。
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,服务端会以增量事件返回内容,客户端负责按事件拼接。这种方式可用于对话界面的逐字显示,批量任务不必开启。