DEEPseek 的使用教程：使用官方DeepSeek服务/使用自建DeepSeek模型

一、使用官方DeepSeek服务

1. 注册与API密钥获取

访问 DeepSeek官网注册账号
进入控制台 → API管理 → 创建API密钥
记录 DEEPSEEK_API_KEY（密钥仅显示一次，需妥善保存）

2. 通过API调用（Python示例）

import requests

# 设置API密钥
headers = {
    "Authorization": "Bearer your_api_key_here",
    "Content-Type": "application/json"
}

# 请求体配置
data = {
    "model": "deepseek-chat",  # 可选模型：deepseek-chat / deepseek-coder
    "messages": [
        {"role": "user", "content": "用Python实现快速排序算法"}
    ],
    "temperature": 0.7,  # 控制随机性（0-2，越大越随机）
    "max_tokens": 1000    # 最大生成长度
}

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

# 解析响应
if response.status_code == 200:
    result = response.json()
    print(result['choices'][0]['message']['content'])
else:
    print(f"错误代码 {response.status_code}: {response.text}")

3. 常用参数说明

参数	说明
`model`	`deepseek-chat`（通用对话） / `deepseek-coder`（代码专用）
`temperature`	值越大输出越随机（默认0.7），代码场景建议设为0.3-0.5
`top_p`	核采样概率（0-1），与temperature二选一
`stream`	设为 `True` 启用流式输出（适合长文本生成）

4. 代码生成专用示例

data = {
    "model": "deepseek-coder",
    "messages": [
        {"role": "user", "content": "写一个Python函数，检测给定的数是否为质数"}
    ],
    "temperature": 0.3,
    "stop": ["\n\n"]  # 停止生成标记 }

二、使用自建DeepSeek模型

1. 通过API调用（基于FastAPI服务）

import requests

response = requests.post(
    "http://localhost:8000/ask",
    json={"prompt": "如何学习机器学习？请分步骤说明"}
)
print(response.json()["response"])

2. 使用Gradio网页界面

启动服务后访问 http://localhost:7860

输入框直接提问，例如：

用PyTorch实现一个简单的CNN网络

支持对话历史查看和多轮交互

三、高级功能

1. 文件解析（需开通高级权限）

# 上传PDF/Word文件进行分析
files = {'file': open('report.pdf', 'rb')}
response = requests.post(
    "https://api.deepseek.com/v1/files/analyze",
    headers=headers,
    files=files,
    data={"purpose": "summary"}  # 可选：summary/qa/extract
)

2. 联网搜索（需开通插件权限）

data = {
    "messages": [
        {"role": "user", "content": "今日国际金价是多少？"},
    ],
    "web_search": True  # 启用联网检索
}

四、注意事项

用量限制
- 免费版：50次/天请求
- 付费版：按阶梯计费（详见官网定价）
内容安全
- 自动过滤敏感内容，违规请求返回 403 错误码
最佳实践
- 代码场景：使用 deepseek-coder 模型 + temperature=0.3
- 长文本生成：启用 stream=True 避免超时

五、常见问题解决

认证失败
```
{"error": {"code": 401, "message": "Invalid API key"}}
```
- 检查API密钥是否正确
- 确认请求头格式：Bearer your_key
响应速度慢
- 减少 max_tokens 值
- 自建部署时启用GPU加速
生成内容不相关
- 调整 temperature 参数（降低随机性）
- 使用更明确的指令格式：
```
请以要点形式回答，不超过3条：[你的问题]
```