deepseek API开发简介

1、申请deepseek api key：

https://platform.deepseek.com/api_keys

创建API Key，并复制Key

2、安装python、pip，然后安装requests

pip install requests

3、.示例代码

import requests
import json

# DeepSeek API 地址
API_URL = "https://api.deepseek.com/v1/chat/completions"

# 你的 API 密钥
API_KEY = "your_api_key_here"

# 请求头
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 请求体
data = {
    "model": "deepseek-chat",  # 使用的模型
    "messages": [
        {"role": "user", "content": "你好，请介绍一下 DeepSeek。"}
    ],
    "max_tokens": 100  # 最大生成 token 数
}

# 发送请求
response = requests.post(API_URL, headers=headers, json=data)

# 处理响应
if response.status_code == 200:
    result = response.json()
    print("API 响应：", json.dumps(result, indent=2, ensure_ascii=False))
else:
    print("请求失败，状态码：", response.status_code)
    print("错误信息：", response.text)

此处API_KEY的值(your_api_key_here)用第一步复制的Key替代。程序运行结果如下：

4、常见 API 接口
以下是 DeepSeek 可能提供的常见 API 接口（具体以官方文档为准）：

(1) 文本生成
功能：生成自然语言文本。
请求体：

{
  "model": "deepseek-chat",
  "messages": [
      {"role": "user", "content": "你好，请写一篇关于人工智能的文章。"}
  ],
  "max_tokens": 200
}

完整代码实现如下：

import requests
import json

# DeepSeek API 地址
API_URL = "https://api.deepseek.com/v1/chat/completions"

# 你的 API 密钥
API_KEY = "your_api_key_here"

# 请求头
headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

# 请求体
data = {
  "model": "deepseek-chat",
  "messages": [
      {"role": "user", "content": "你好，请写一篇关于人工智能的文章。"}
  ],
  "max_tokens": 200
}

# 发送请求
response = requests.post(API_URL, headers=headers, json=data)

# 处理响应
if response.status_code == 200:
    result = response.json()
    print("API 响应：", json.dumps(result, indent=2, ensure_ascii=False))
else:
    print("请求失败，状态码：", response.status_code)
    print("错误信息：", response.text)

(2) 文本分类
功能：对文本进行分类。
请求体data ：

{
  "model": "deepseek-classify",
  "text": "这是一条关于科技新闻的内容。",
  "categories": ["科技", "体育", "娱乐"]
}

(3) 文本翻译
功能：将文本翻译为目标语言。
请求体data ：

{
  "model": "deepseek-translate",
  "text": "Hello, how are you?",
  "target_language": "zh"
}

(4) 语音转文本
功能：将语音文件转换为文本。
请求体data：

{
  "model": "deepseek-speech",
  "audio_url": "https://example.com/audio.wav"
}

(5)错误处理
在调用 API 时，可能会遇到以下错误：

401 Unauthorized：API 密钥无效或未提供。
400 Bad Request：请求体格式错误或缺少必要参数。
429 Too Many Requests：请求频率超出限制。
500 Internal Server Error：服务器内部错误。

建议在代码中加入错误处理逻辑，例如：

if response.status_code == 401:
    print("认证失败，请检查 API 密钥。")
elif response.status_code == 400:
    print("请求参数错误：", response.json().get("error", {}).get("message"))
elif response.status_code == 429:
    print("请求频率过高，请稍后重试。")
elif response.status_code == 500:
    print("服务器内部错误，请联系 DeepSeek 支持。")

6. 调试与优化
   调试工具：使用 Postman 或 curl 测试 API 请求。
   性能优化：减少不必要的请求，合理设置 max_tokens 和 temperature 参数。
   日志记录：记录 API 请求和响应，便于排查问题。