快速开始

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

参数	值
base_url ^*	`https://api.deepseek.com`
api_key	申请 API key

* 出于与 OpenAI 兼容考虑，您也可以将 base_url 设置为 https://api.deepseek.com/v1 来使用，但注意，此处 v1 与模型版本无关。

调用对话 API

在创建 API key 之后，你可以使用以下样例脚本的来访问 DeepSeek API。样例为非流式输出，您可以将 stream 设置为 true 来使用流式输出。

# 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
      }'

# python3
# Please install OpenAI SDK first：`pip3 install openai`
from openai import OpenAI

client = OpenAI(api_key="<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)

模型

模型	描述	上下文长度	最大输出长度
deepseek-chat ⁽¹⁾	擅长通用对话任务	32K ⁽²⁾	4K
deepseek-coder ⁽¹⁾	擅长处理编程和数学任务	32K ⁽²⁾	4K

(1) deepseek-chat 和 deepseek-coder 后端模型已更新为 DeepSeek-V2 和 DeepSeek-Coder-V2，无需修改模型名称即可访问。
(2) DeepSeek-V2 与 DeepSeek-Coder-V2 开源版本支持 128K 上下文，API/网页版本支持 32K 上下文。

模型 `temperature` 设置

temperature 参数默认为 1.0。

对于 deepseek-coder，我们建议您使用默认 temperature 值（1.0）。
对于 deepseek-chat，我们建议您根据如下表格，按使用场景设置 temperature。

场景	温度
代码生成/数学解题	0.0
数据抽取/分析	0.7
通用对话	1.0
翻译	1.1
创意类写作/诗歌创作	1.25

限速

每个账户的速率限制会根据我们实时的流量压力动态调整。当我们的服务器承受高流量压力时，您可能会收到 429（请求速率达到上限）或 503（服务器繁忙）的错误。当这种情况发生时，请稍等片刻再重试。我们也建议您临时切换到其它大模型厂商（如 OpenAI）的 API。

Token & Token 用量计算

token 是模型用来表示自然语言文本的基本单位，也是我们的计费单元，可以直观的理解为“字”或“词”；通常 1 个中文词语、1 个英文单词、1 个数字或 1 个符号计为 1 个 token。

一般情况下模型中 token 和字数的换算比例大致如下：

1 个英文字符 ≈ 0.3 个 token。
1 个中文字符 ≈ 0.6 个 token。

但因为不同模型的分词不同，所以换算比例也存在差异，每一次实际处理 token 数量以模型返回为准，您可以从返回结果的 usage 中查看。

错误码

您在调用 DeepSeek API 时，可能会遇到以下错误。这里列出了相关错误的原因及其解决方法。

错误码	描述
400 - 格式错误	原因：请求体格式错误解决方法：请根据错误信息提示修改请求体
401 - 认证失败	原因：API key 错误，认证失败解决方法：请检查您的 API key 是否正确，如没有 API key，请先创建 API key
402 - 余额不足	原因：账号余额不足解决方法：请确认账户余额，并前往充值页面进行充值
422 - 参数错误	原因：请求体参数错误解决方法：请根据错误信息提示修改相关参数
429 - 请求速率达到上限	原因：请求速率（TPM 或 RPM）达到上限解决方法：请合理规划您的请求速率。我们也建议您临时切换到其它大模型厂商（如 OpenAI）的 API
500 - 服务器故障	原因：服务器内部故障解决方法：请等待后重试。若问题一直存在，请联系我们解决
503 - 服务器繁忙	原因：服务器负载过高解决方法：请稍后重试您的请求

快速开始

调用对话 API​

模型​

模型 temperature 设置​

限速​

Token & Token 用量计算​

错误码​

调用对话 API

模型

模型 `temperature` 设置

限速

Token & Token 用量计算

错误码