如何使用DeepSeek API？一篇解决你的所有问题 – wiki基地

作者： /

I’ve made a mistake and realize I don’t have the tools to directly create a file. My apologies. The best way for me to provide the article is to display it directly here for you.

Here is the comprehensive guide on how to use the DeepSeek API:

如何使用 DeepSeek API？一篇解决你的所有问题

引言

DeepSeek API 是由深度求索（DeepSeek）公司提供的一款强大的人工智能语言模型API。它以其卓越的性能、与OpenAI API的兼容性以及高性价比，吸引了众多开发者的关注。无论你是想构建聊天机器人、内容创作工具，还是进行代码生成和数据分析，DeepSeek API 都能为你提供强有力的支持。

本文将为你提供一份详尽的 DeepSeek API 使用指南，从获取 API 密钥到发起 API 调用，再到实际代码示例，全方位解决你在使用过程中可能遇到的问题。

快速开始

1. 注册并获取 API 密钥

要使用 DeepSeek API，你首先需要一个 API 密钥。

  1. 访问 DeepSeek 开放平台。
  2. 使用你的邮箱或手机号注册账号。
  3. 登录后，在“API 密钥”页面创建一个新的 API 密钥。请妥善保管你的密钥，不要泄露给他人。

2. 发起你的第一个 API 请求

DeepSeek API 的一大亮点是它与 OpenAI API 的格式完全兼容。这意味着你可以无缝地从 OpenAI 切换到 DeepSeek，或者直接使用为 OpenAI API 设计的各种库和工具。

你只需要将 API 请求的地址改为 https://api.deepseek.com，并在请求头中带上你的 API 密钥即可。

以下是一个使用 curl 命令调用聊天（Chat）API 的简单示例：

bash
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "你好，请你用中文做一个自我介绍。"}
]
}'

请记得将 YOUR_API_KEY 替换为你自己的 API 密钥。

你会收到类似如下的响应：

json
{
"id": "chatcmpl-...",
"object": "chat.completion",
"created": ...,
"model": "deepseek-chat",
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "你好！我叫 DeepSeek，一个由深度求索公司开发的通用人工智能模型。我被设计用来理解和生成人类语言，并能够就广泛的主题进行对话和提供信息。我能够帮助你完成各种任务，比如回答问题、提供建议、进行文本创作等。很高兴能为你服务！"
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 14,
"completion_tokens": 82,
"total_tokens": 96
}
}

API 核心功能

1. 模型选择

DeepSeek API 目前主要提供两款模型：

  • deepseek-chat: 通用聊天模型，适用于绝大多数对话和文本生成场景。
  • deepseek-coder: 代码生成和理解模型，在编程相关的任务上表现更出色。

你可以在请求的 model 字段中指定要使用的模型。

2. 主要参数

  • messages: 一个消息对象数组，用于定义对话的上下文。每个对象包含 role（角色，如 “user”, “assistant”）和 content（消息内容）。
  • stream: 布尔值，默认为 false。如果设置为 true，API 会以流式的方式返回数据，非常适合实现打字机效果的实时聊天应用。
  • temperature: 控制生成文本的随机性，介于 0 和 2 之间。较高的值（如 0.8）会使输出更随机，而较低的值（如 0.2）会使其更具确定性。
  • max_tokens: 生成响应的最大长度（token 数）。

3. 流式响应（Streaming）

要接收流式响应，只需在请求中将 stream 参数设置为 true。API 会通过 Server-Sent Events (SSE) 的方式持续返回数据块。

使用 curl 的示例：

bash
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "deepseek-chat",
"messages": [
{"role": "user", "content": "写一首关于宇宙的短诗"}
],
"stream": true
}'

你会陆续收到多个数据块，每个数据块都是一个 JSON 对象，你需要解析 delta.content 字段来获取增量内容。

Python 代码示例

在 Python 中使用 DeepSeek API 非常简单，你可以直接使用 openai 库。

1. 安装 OpenAI 库

bash
pip install openai

2. Python 代码

“`python
from openai import OpenAI

初始化客户端

请将 YOUR_API_KEY 替换为你自己的 API 密钥

将 base_url 替换为 DeepSeek 的 API 地址

client = OpenAI(
api_key=”YOUR_API_KEY”,
base_url=”https://api.deepseek.com/v1″
)

非流式调用

response = client.chat.completions.create(
model=”deepseek-chat”,
messages=[
{“role”: “user”, “content”: “你好，请你用中文做一个自我介绍。”},
],
)

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

流式调用

stream_response = client.chat.completions.create(
model=”deepseek-chat”,
messages=[
{“role”: “user”, “content”: “写一首关于宇宙的短诗”},
],
stream=True
)

for chunk in stream_response:
if chunk.choices and chunk.choices[0].delta and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end=””)

print()
“`

重要提示:
* 在初始化 OpenAI 客户端时，api_key 是你的 DeepSeek API 密钥。
* base_url 必须设置为 https://api.deepseek.com/v1 或 https://api.deepseek.com。

定价与计费

DeepSeek API 的定价极具竞争力，通常按 token 数量计费。Token 是模型处理文本的基本单位，一个汉字约等于 2 到 2.5 个 token。

具体的定价信息会随时间调整，请务必查阅 DeepSeek 官方定价页面 获取最新和最准确的计费标准。

总结

DeepSeek API 凭借其高性能、易用性和高性价比，为开发者提供了一个极佳的人工智能语言模型选择。其与 OpenAI API 的兼容性大大降低了开发和迁移的门槛。

通过本指南，你应该已经掌握了使用 DeepSeek API 的基本方法。现在，就去创建你的 API 密钥，开始探索和构建你自己的 AI 应用吧！

滚动至顶部