DeepSeek API的详细技术文档主要包括API的基础信息、模型概览、调用示例、认证方式、主要API端点、错误处理、使用限制与最佳实践等内容。以下是对这些内容的详细归纳：
一、基础信息
- 兼容格式：DeepSeek API兼容OpenAI格式，可直接使用OpenAI SDK或兼容软件调用。
- 基础地址：API请求的基础地址为https://api.deepseek.com。
二、模型概览
- DeepSeek-V3：原deepseek-chat升级版本，接口不变，通过指定model='deepseek-chat'调用。
- DeepSeek-R1：推理模型，原deepseek-reasoner，通过指定model='deepseek-reasoner'调用。
三、调用示例
DeepSeek API提供了多种编程语言的调用示例，包括curl、Python、Node.js等。以下是一个Python调用示例：
import requests url = "https://api.deepseek.com/v1/chat/completions" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } data = { "model": "deepseek-chat", "messages": [ {"role": "user", "content": "你好,请介绍DeepSeek的功能。"} ] } response = requests.post(url, json=data, headers=headers) print(response.json())四、认证方式
- 认证类型：Bearer Token。
- 使用方法：在请求头中添加Authorization: Bearer {API_KEY}。API密钥需通过DeepSeek平台获取，并妥善保管。
五、主要API端点
聊天交互
- 端点：POST /v1/chat/completions
- 功能：生成多轮对话响应。
- 参数：
- model（必填）：模型ID，如deepseek-chat。
- messages（必填）：消息列表，包含role（user/assistant）和content。
- temperature（可选）：控制生成随机性（0-2，默认1）。
- stream（可选）：是否启用流式传输（布尔值）。
- 响应示例：
获取模型列表
- 端点：GET /v1/models
- 功能：列出可用模型。
- 响应示例：
图片生成
- 端点：POST /v1/images/generations
- 功能：根据描述生成图片。
- 参数：
- prompt（必填）：图片描述文本。
- model（必填）：如deepseek-image。
- size（可选）：图片尺寸（默认1024x1024）。
- 响应示例：
文本嵌入
- 端点：POST /v1/embeddings
- 功能：生成文本向量表示。
- 参数：
- input（必填）：输入文本或文本列表。
- model（必填）：如deepseek-embed。
- 响应示例：
六、错误处理
- 常见错误码及含义：
- 401 Unauthorized：API密钥无效或缺失。
- 400 Bad Request：请求参数错误（如必填字段缺失）。
- 429 Too Many Requests：超出速率限制。
- 500 Internal Server Error：服务器内部错误。
- 错误响应结构：{ "error": { "code": 401, "message": "无效的API密钥", "type": "invalid_request_error" } }
七、使用限制与最佳实践
- 速率限制：免费用户每分钟最多60次请求，付费用户按套餐调整。
- 重试建议：遇到429错误时，建议等待1分钟后重试。
- 流式响应：长文本生成建议启用stream参数以提升体验。
八、注意事项
- 在调用DeepSeek API之前，需要确保系统环境满足要求，包括操作系统、开发语言和网络连接等。
- 注册成功后，在DeepSeek开放平台的左侧边栏找到“API Keys”选项，创建一个新的API Key，并将其复制并保存在一个安全且易于访问的地方。
- DeepSeek API的响应通常包含JSON格式的数据，需要解析这些数据以获取所需的信息。
综上所述，DeepSeek API提供了丰富的功能和灵活的调用方式，可以满足多种应用场景的需求。在调用API时，需要遵守相应的使用限制和最佳实践，以确保API的稳定性和安全性。
