ByteNoteByteNote

字节笔记本

2026年2月21日

DeepSeek API 快速接入指南

API中转
¥120

本文介绍 DeepSeek API 的基本使用方法,帮助开发者快速接入 DeepSeek 大模型服务。

DeepSeek API 简介

DeepSeek API 使用与 OpenAI 兼容的 API 格式,通过修改配置,您可以使用 OpenAI SDK 来访问 DeepSeek API,或使用与 OpenAI API 兼容的软件。

基本配置参数

参数
base_urlhttps://api.deepseek.comhttps://api.deepseek.com/v1
api_keyDeepSeek Platform 申请

注意:此处 v1 与模型版本无关,仅用于兼容 OpenAI SDK。

可用模型

模型名称说明上下文长度
deepseek-chatDeepSeek-V3.2 非思考模式128K
deepseek-reasonerDeepSeek-V3.2 思考模式128K

重要说明deepseek-chatdeepseek-reasoner 对应模型版本固定为 DeepSeek-V3.2(128K 上下文长度),与 APP/WEB 版不同。

首次调用 API

curl 示例

bash
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": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

Python 示例

python
# 请先安装 OpenAI SDK: pip3 install openai
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get('DEEPSEEK_API_KEY'),
    base_url="https://api.deepseek.com"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)

print(response.choices[0].message.content)

Node.js 示例

javascript
// 请先安装 OpenAI SDK: npm install openai
import OpenAI from "openai";

const openai = new OpenAI({
    baseURL: 'https://api.deepseek.com',
    apiKey: process.env.DEEPSEEK_API_KEY,
});

async function main() {
  const completion = await openai.chat.completions.create({
    messages: [{ role: "system", content: "You are a helpful assistant." }],
    model: "deepseek-chat",
  });
  console.log(completion.choices[0].message.content);
}

main();

流式输出

stream 参数设置为 true 即可使用流式输出:

python
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[...],
    stream=True  # 启用流式输出
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="")

主要功能特性

  • 思考模式 - 通过 deepseek-reasoner 模型启用深度推理
  • 多轮对话 - 支持完整的对话上下文管理
  • JSON Output - 结构化输出支持
  • Tool Calls - 函数调用能力
  • 上下文硬盘缓存 - 降低长上下文调用成本
  • FIM 补全 - 代码补全支持(Beta)

相关资源

分享: