DeepSeek API 快速开始指南

欢迎使用 DeepSeek API！本指南将帮助您快速上手，从注册账户到发送第一个API请求。

目录

1. 账户注册和设置
2. 获取API密钥
3. 安装SDK
4. 第一个API调用
5. 常用示例
6. 错误处理
7. 下一步

账户注册和设置

1. 注册账户

访问 [DeepSeek 官网]注册您的账户。

2. 验证邮箱

完成邮箱验证以激活您的账户。

3. 完善个人信息

登录后完善您的个人或企业信息。

获取API密钥

1. 访问控制台

登录后访问 [API 控制台]。

2. 创建API密钥

点击"创建新密钥"按钮，为您的密钥设置一个描述性名称。

3. 保存密钥

重要: 请立即复制并安全保存您的API密钥，它只会显示一次。

# 示例密钥格式（请使用您自己的密钥）
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4. 设置环境变量

为了安全起见，建议将API密钥设置为环境变量：

# Linux/macOS
export DEEPSEEK_API_KEY="your-api-key-here"

# Windows
set DEEPSEEK_API_KEY=your-api-key-here

安装SDK

Python

pip install openai
# 或者
pip install requests

Node.js

npm install openai
# 或者
npm install axios

cURL

cURL 通常已预装在大多数系统中，无需额外安装。

第一个API调用

Python 示例

import os
from openai import OpenAI

# 初始化客户端
client = OpenAI(
    api_key=os.getenv("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com"
)

# 发送聊天请求
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己。"}
    ],
    max_tokens=1024,
    temperature=0.7
)

print(response.choices[0].message.content)

Node.js 示例

const OpenAI = require('openai');

const client = new OpenAI({
    apiKey: process.env.DEEPSEEK_API_KEY,
    baseURL: 'https://api.deepseek.com'
});

async function main() {
    const response = await client.chat.completions.create({
        model: 'deepseek-chat',
        messages: [
            { role: 'user', content: '你好，请介绍一下你自己。' }
        ],
        max_tokens: 1024,
        temperature: 0.7
    });
    
    console.log(response.choices[0].message.content);
}

main();

cURL 示例

curl -X POST "https://api.deepseek.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己。"
      }
    ],
    "max_tokens": 1024,
    "temperature": 0.7
  }'

常用示例

1. 文本生成

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "写一首关于春天的诗"}
    ],
    max_tokens=500,
    temperature=0.8
)

2. 代码生成

response = client.chat.completions.create(
    model="deepseek-coder",
    messages=[
        {"role": "user", "content": "用Python写一个快速排序算法"}
    ],
    max_tokens=1000,
    temperature=0.1
)

3. 问答对话

messages = [
    {"role": "system", "content": "你是一个有用的AI助手。"},
    {"role": "user", "content": "什么是机器学习？"},
]

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=messages,
    max_tokens=800,
    temperature=0.5
)

# 继续对话
messages.append({"role": "assistant", "content": response.choices[0].message.content})
messages.append({"role": "user", "content": "能给我一个简单的例子吗？"})

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=messages,
    max_tokens=800,
    temperature=0.5
)

4. 流式输出

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "请详细解释什么是人工智能"}
    ],
    stream=True,
    max_tokens=1000
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="")

5. JSON 模式输出

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "生成一个包含姓名、年龄、职业的人物信息，以JSON格式返回"}
    ],
    response_format={"type": "json_object"},
    max_tokens=200
)

错误处理

Python 错误处理

from openai import OpenAI
import openai

try:
    response = client.chat.completions.create(
        model="deepseek-chat",
        messages=[{"role": "user", "content": "Hello"}],
        max_tokens=100
    )
    print(response.choices[0].message.content)
    
except openai.AuthenticationError:
    print("认证失败，请检查API密钥")
except openai.RateLimitError:
    print("请求频率超限，请稍后重试")
except openai.APIError as e:
    print(f"API错误: {e}")
except Exception as e:
    print(f"其他错误: {e}")

常见错误代码

状态码	错误类型	描述	解决方案
400	Bad Request	请求参数错误	检查请求参数格式
401	Unauthorized	认证失败	检查API密钥
429	Too Many Requests	请求频率超限	降低请求频率
500	Internal Server Error	服务器内部错误	稍后重试

参数说明

常用参数

参数	类型	描述	默认值
model	string	使用的模型名称	必需
messages	array	对话消息列表	必需
max_tokens	integer	最大输出token数	4096
temperature	float	控制输出随机性 (0-2)	1.0
top_p	float	核采样参数 (0-1)	1.0
stream	boolean	是否流式输出	false

模型选择

模型名称	适用场景	特点
deepseek-chat	通用对话	平衡性能和效果
deepseek-coder	代码生成	专门优化代码任务

使用限制

速率限制

• 免费用户: 每分钟 20 次请求
• 付费用户: 根据订阅计划而定

Token 限制

• 输入: 最大 32K tokens
• 输出: 最大 4K tokens

内容政策

请确保您的请求符合 [DeepSeek 使用政策]。

下一步

现在您已经成功发送了第一个API请求，可以探索更多功能：

1. 深入学习

• API 参考文档 - 完整的API文档
• 函数调用指南 - 学习如何使用函数调用
• JSON 模式指南 - 结构化输出

2. 高级功能

• KV 缓存 - 优化长对话性能
• 批量处理 - 处理大量请求

3. 最佳实践

• 代码生成指南 - 编写更好的提示和代码生成
• 错误处理 - 处理各种错误情况
• 性能优化 - 提升应用性能

4. 社区资源

• 更多代码示例
• [社区论坛] - 与其他开发者交流
• 技术支持 - 获取技术支持

常见问题

Q: 如何获得更高的速率限制？

A: 升级到付费计划可以获得更高的速率限制和更多功能。

Q: 支持哪些编程语言？

A: DeepSeek API 是基于 HTTP 的 REST API，支持所有能发送 HTTP 请求的编程语言。

Q: 如何计算 Token 使用量？

A: 可以使用 Token 计算器或查看 Token 使用指南。

Q: API 有地域限制吗？

A: 请查看 服务条款了解详细的地域限制信息。

---