DeepSeek API使用教程丨如何获取和调用?

体验DeepSeek最简单的方式,就是使用网页版或手机app,可参考DeepSeek丨中文官网、API申请使用、App下载等百科常识丨AI 指南https://aizhinan.cc/sites/184 。

也可以使用DeepSeek第三方应用、插件,可参考DeepSeek集成工具大全:电脑软件、手机应用、浏览器AI插件、代码编辑器丨AI 指南》https://aizhinan.cc/190

如果选择第三方应用或扩展使用,那么就需要获取 DeepSeek API Key

DeepSeek API, 是DeepSeek的编程接口;DeepSeek API Key,就是DeepSeek应用程序编程接口的密钥,是一串特定的字符组合,用于验证和授权访问权限。

如何申请、使用DeepSeek API Key

DeepSeek API使用教程丨如何获取和调用?
图片丨在DeepSeek开放平台页创建API Key
  • 注册账号:访问DeepSeek官网,点击右上角「API开放平台」,或者点击首页中间的「开始对话」创建账号。
  • 申请DeepSeek API Key:登录后,进入「API开放平台」页面,再点击左侧「API Keys」,点击「创建API Key」,生成后妥善保存,因为只明文显示一次。如果生成后没有及时保存,将来再使用时只能重新创建。
  • 安装SDK(可选):可选择安装官方提供的SDK,方便调用API。若不安装,也能直接通过HTTP请求调用。
  • 配置信息:在代码中配置API密钥和基础URL,基础URL为 https://api.deepseek.com 或 https://api.deepseek.com/v1 。
  • 模型选择:各自说明见下文。
    • 通用模型(已升级为DeepSeek-V3)deepseek-chat
    • 代码模型deepseek-coder
    • 推理模型(DeepSeek-R1)deepseek-reasoner
  • 构建请求:根据要调用的API接口,构建相应请求数据。
  • 发送请求并处理响应:发送HTTP请求,处理返回的响应数据。如使用Python和requests库调用。

三步快速接入:

id: api_code_sample
name: API调用示例
type: code.py
content: |-
  import requests

  # 1. 获取API密钥
  DEEPSEEK_API_KEY = "sk-xxxxxxxxxxxxxxxx"  # 替换成你的密钥

  # 2. 创建请求
  headers = {
      "Authorization": f"Bearer {DEEPSEEK_API_KEY}",
      "Content-Type": "application/json"
  }

  data = {
      "model": "deepseek-chat",
      "messages": [
          {"role": "user", "content": "你好!"}
      ],
      "temperature": 0.7
  }

  # 3. 发送请求
  response = requests.post(
      "<https://api.deepseek.com/v1/chat/completions>",
      headers=headers,
      json=data
  )

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

核心参数说明:

{
  "model": "deepseek-chat",  # 可用模型:deepseek-chat / deepseek-coder
  "messages": [              # 对话历史
    {"role": "system", "content": "你是有帮助的AI助手"},
    {"role": "user", "content": "请解释量子计算"}
  ],
  "temperature": 0.7,        # 创造性 (0-2)
  "max_tokens": 1024,        # 最大输出长度
  "top_p": 0.9,              # 采样阈值
  "stream": True             # 启用流式输出
}

最佳实践:

  1. 密钥获取:登录 DeepSeek控制台 创建API Key
  2. 模型选择
    • deepseek-chat: 通用模型,适用对话场景;该模型已全面升级为 DeepSeek-V3,接口没变, 通过指定 model=’deepseek-chat’, 即可直接调用 DeepSeek-V3。
    • deepseek-coder: 代码模型,代码生成/分析场景。
    • deepseek-reasoner: 推理模型,即 DeepSeek 最新推出的推理模型 DeepSeek-R1。通过指定 model=’deepseek-reasoner’,即可调用 DeepSeek-R1。
  3. 错误处理
if response.status_code == 200:
    # 处理成功响应
elif response.status_code == 401:
    print("认证失败,请检查API Key")
elif response.status_code == 429:
    print("请求频率超限")

DeepSeek API错误代码含义、原因及解决方法:

在调用 DeepSeek API 的时候,可能出现各种错误代码,其含义、原因及解决方法如下:

400——格式错误:原因是请求体格式不对。解决办法,按照错误信息的提示修改请求体。
401——认证失败:原因是 DeepSeek API Key 错了,认证没通过。解决办法,检查你的 API key 对不对,如果没有 API key 需要创建一个。
402——余额不足:原因就是账号里钱不够了。解决办法,确认一下账户余额,然后去DeepSeek「充值」页面充值。
422——参数错误:原因是请求体参数不对。解决办法,按照错误信息提示,把相关参数改正。
429——请求速率达到上限:原因是请求速率(TPM 或 RPM)到上限了。解决办法,合理规划一下你的请求速率。
500——服务器故障:原因是服务器内部出问题了。解决办法,等会儿再试试。因为最近霉国持续攻击DeepSeek,所以经常出现500、503错误。
503——服务器繁忙:原因是服务器负载太高了。解决办法,等会儿再试试你的请求。

参考:DeepSeek API 官方使用指南文档丨DeepSeek API Docshttps://api-docs.deepseek.com/zh-cn/

更多相关文章:

《专题丨DeepSeek使用教程》https://aizhinan.cc/tag/deepseek-tutorial

《专题丨人工智能技术和应用案例教程》https://aizhinan.cc/ai-tutorial

《专题丨AI人工智能领域最新前沿资讯、未来发展趋势展望》https://aizhinan.cc/ai-news

禁止转载丨原文链接:https://aizhinan.cc/183

版权声明:AI 指南 发表于 2025年2月1日 pm10:53。
禁止转载:DeepSeek API使用教程丨如何获取和调用? | AI 指南

相关文章