DeepSeek API 参考文档
本文档提供 DeepSeek API 的完整参考信息，包括所有可用的端点、参数说明和使用示例。
API 概览
DeepSeek API 提供了强大的人工智能能力，支持文本生成、对话、代码生成等多种应用场景。
基础信息
- API 基础URL:
https://api.deepseek.com - 认证方式: Bearer Token
- 支持格式: JSON
- 请求方法: POST
核心 API 端点
1. 聊天补全 API (Chat Completions)
端点: /v1/chat/completions
用于创建对话式AI应用，支持多轮对话和上下文理解。
主要特性:
- 支持多轮对话
- 上下文记忆
- 流式输出
- 函数调用
- JSON模式输出
相关文档:
2. 文本补全 API (Completions)
端点: /v1/completions
用于文本生成和补全任务，适合单次文本生成场景。
主要特性:
- 文本续写
- 代码补全
- 创意写作
- 文档生成
相关文档:
3. 模型列表 API (Models)
端点: /v1/models
获取可用的AI模型信息和规格。
主要特性:
- 查看可用模型
- 模型规格信息
- 性能参数
- 定价信息
相关文档:
4. 用户余额 API (User Balance)
端点: /v1/user/balance
查询账户使用情况和余额信息。
主要特性:
- 余额查询
- 使用统计
- 消费记录
- 配额管理
相关文档:
快速开始
1. 获取 API 密钥
访问 DeepSeek 控制台 获取您的 API 密钥。
2. 基础请求示例
bash
curl -X POST "https://api.deepseek.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{
"role": "user",
"content": "Hello, how are you?"
}
]
}'3. Python 示例
python
import requests
url = "https://api.deepseek.com/v1/chat/completions"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_KEY"
}
data = {
"model": "deepseek-chat",
"messages": [
{
"role": "user",
"content": "Hello, how are you?"
}
]
}
response = requests.post(url, headers=headers, json=data)
print(response.json())高级功能
函数调用 (Function Calling)
DeepSeek API 支持函数调用功能，允许模型调用外部工具和服务。
相关指南:
JSON 模式
强制模型输出有效的 JSON 格式数据。
相关指南:
流式输出
支持实时流式输出，提供更好的用户体验。
KV 缓存
优化长对话的性能和成本。
相关指南:
错误处理
API 使用标准的 HTTP 状态码来表示请求结果：
200- 请求成功400- 请求参数错误401- 认证失败429- 请求频率超限500- 服务器内部错误
详细错误代码:
限制和配额
速率限制
API 有请求频率限制，具体限制取决于您的订阅计划。
相关文档:
Token 使用
了解如何计算和优化 Token 使用。
相关文档:
定价
查看最新的 API 定价信息。
相关文档:
更多资源
社区和支持
如果您在使用过程中遇到问题，可以通过以下方式获取帮助：
最后更新: 2025年1月27日