DeepSeek API 文档介绍

DeepSeek API 文档*，涵盖 API 的基本信息、请求参数、响应格式和示例代码

---

DeepSeek API 文档

DeepSeek API 提供了强大的自然语言处理和代码生成能力，适用于多种场景。以下是 API 的使用说明。

---

1. API 基本信息

• API 地址：https://api.deepseek.com/v1/generate
• 请求方法：POST
• 认证方式：Bearer Token
• Content-Type：application/json

---

2. 请求参数

Headers

参数名	类型	必填	描述
Authorization	String	是	Bearer Token，格式：Bearer {api_key}
Content-Type	String	是	固定值：application/json

Body

参数名	类型	必填	描述
prompt	String	是	输入的提示文本
max_tokens	Int	否	生成内容的最大长度（默认 100）
temperature	Float	否	生成内容的随机性（默认 0.7）
top_p	Float	否	生成内容的多样性（默认 1.0）

---

3. 响应格式

成功响应

{
  "id": "cmpl-1234567890",
  "object": "text_completion",
  "created": 1677654321,
  "model": "deepseek-v1",
  "choices": [
    {
      "text": "生成的文本内容",
      "index": 0,
      "logprobs": null,
      "finish_reason": "length"
    }
  ],
  "usage": {
    "prompt_tokens": 10,
    "completion_tokens": 50,
    "total_tokens": 60
  }
}

字段说明

字段名	类型	描述
id	String	请求的唯一标识符
object	String	对象类型（固定值：text_completion）
created	Int	请求时间戳
model	String	使用的模型名称
choices	Array	生成的内容列表
choices[].text	String	生成的文本内容
choices[].index	Int	内容索引
usage	Object	Token 使用情况
usage.prompt_tokens	Int	提示文本的 Token 数量
usage.completion_tokens	Int	生成内容的 Token 数量
usage.total_tokens	Int	总 Token 数量

错误响应

{
  "error": {
    "message": "错误信息",
    "type": "invalid_request_error",
    "code": 400
  }
}

---

4. 示例代码

Python 示例

import requests

api_key = "your_deepseek_api_key"
url = "https://api.deepseek.com/v1/generate"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}
data = {
    "prompt": "生成一段关于春天的诗歌",
    "max_tokens": 50
}
response = requests.post(url, headers=headers, json=data)
print(response.json())

cURL 示例

curl -X POST "https://api.deepseek.com/v1/generate" \
     -H "Authorization: Bearer your_deepseek_api_key" \
     -H "Content-Type: application/json" \
     -d '{
           "prompt": "生成一段关于春天的诗歌",
           "max_tokens": 50
         }'

---

5. 常见问题

Q1：如何获取 API Key？

• 访问 DeepSeek 官网，注册账号并生成 API Key。

Q2：如何提高生成内容的质量？

• 调整 temperature 和 top_p 参数，控制生成内容的随机性和多样性。
• 提供更详细的 prompt，明确生成内容的主题和格式。

Q3：API 调用频率有限制吗？

• 免费用户通常有每分钟和每月的调用限制，具体限制请参考官网文档。

---

6. 参考链接

• DeepSeek 官方文档
• API 认证指南

（请大家先关注我,后续还会更新!!!）