DeepSeek API 使用指南:R1 推理模型接入教程
什么是 DeepSeek API?
DeepSeek API 是由深度求索(DeepSeek)公司提供的大模型推理服务接口,目前提供两个主要版本:
- DeepSeek V3 - 128K 上下文窗口的通用大模型
- DeepSeek R1 - 专门优化的推理增强版本,在数学和代码任务上表现突出
通过無量Api(api2everything.xyz)接入 DeepSeek API 有以下优势:
- 国内直连无需翻墙,延迟低于 200ms
- 价格仅为官方 API 的 3-5 折
- 100% 兼容 OpenAI SDK 格式,只需修改 base_url
- 支持支付宝/微信支付,按量计费无月费
快速开始:Python 接入示例
1. 安装 OpenAI SDK
pip install openai
2. 调用 DeepSeek R1 API
from openai import OpenAI
client = OpenAI(
api_key="您的API密钥",
base_url="https://api2everything.xyz/v1" # 無量Api接入点
)
response = client.chat.completions.create(
model="deepseek-r1",
messages=[
{"role": "system", "content": "你是一个专业的AI助手"},
{"role": "user", "content": "解释量子计算的基本原理"}
],
temperature=0.7,
max_tokens=2000
)
print(response.choices[0].message.content)
3. 调用 DeepSeek V3 API
只需将 model 参数改为 "deepseek-v3":
response = client.chat.completions.create(
model="deepseek-v3",
messages=[...],
# 其他参数相同
)
Node.js 接入指南
1. 安装 OpenAI 包
npm install openai
2. 调用示例
import OpenAI from 'openai';
const openai = new OpenAI({
apiKey: '您的API密钥',
baseURL: 'https://api2everything.xyz/v1' // 無量Api接入点
});
async function main() {
const completion = await openai.chat.completions.create({
model: "deepseek-r1",
messages: [
{ role: "user", content: "用Python实现快速排序算法" }
],
temperature: 0.3
});
console.log(completion.choices[0].message);
}
main();
API 参数详解
必选参数
| 参数 | 类型 | 说明 |
|---|---|---|
| model | string | 模型标识:deepseek-v3 或 deepseek-r1 |
| messages | array | 消息列表,包含 role (system/user/assistant) 和 content |
可选参数
| 参数 | 默认值 | 说明 |
|---|---|---|
| temperature | 0.7 | 0-2,值越高输出越随机 |
| max_tokens | 2048 | 最大生成token数(R1最大4096,V3最大128K) |
| top_p | 1 | 0-1,核采样概率阈值 |
DeepSeek V3 与 R1 模型对比
| 特性 | DeepSeek V3 | DeepSeek R1 |
|---|---|---|
| 上下文窗口 | 128K tokens | 32K tokens |
| 最佳场景 | 长文档处理、知识问答 | 数学推理、代码生成 |
| 推理速度 | 中等 | 快速 |
| 价格(無量Api) | ¥0.8/百万tokens | ¥1.2/百万tokens |
常见问题(FAQ)
Q1: 如何获取 API Key?
在無量Api官网 api2everything.xyz 注册后,在控制台即可获取 API Key,新用户赠送免费体验额度。
Q2: 为什么选择無量Api而非官方API?
- 价格优势:仅为官方价格的30-50%
- 网络优化:国内服务器直连,延迟更低
- 支付便利:支持支付宝/微信支付
- 多模型支持:一个API Key可访问300+模型
Q3: 如何估算API调用成本?
计算公式:总费用 = (输入tokens + 输出tokens) × 单价
示例:使用DeepSeek R1处理1000次请求,平均每次输入500tokens,输出300tokens:
(500 + 300) × 1000 × ¥1.0000012 / 1,000,000 = ¥0.96
Q4: 遇到 "429 Too Many Requests" 错误怎么办?
無量Api默认限速为:
- 免费用户:60次/分钟
- 付费用户:300次/分钟
- 可联系客服申请提升限额
最佳实践建议
1. 系统提示词优化
DeepSeek R1 对系统提示词(system prompt)响应良好:
messages=[
{
"role": "system",
"content": "你是一个专业的数学导师,用中文回答,给出详细解题步骤"
},
# 用户消息...
]
2. 流式传输处理长内容
对于长文本生成,建议使用流式响应:
stream = client.chat.completions.create(
model="deepseek-v3",
messages=[...],
stream=True
)
for chunk in stream:
print(chunk.choices[0].delta.content or "", end="")
3. 结合函数调用功能
DeepSeek V3 支持函数调用:
response = client.chat.completions.create(
model="deepseek-v3",
messages=[...],
tools=[...], # 函数定义
tool_choice="auto"
)