1、申请DeepSeek的API

  进入 DeepSeek 开放平台，网址为：https://platform.deepseek.com/usage

  找到 API keys 申请API，充点钱就可以正常使用了，下面代码我将用 sk-123456 来代表我的API。

  下面我将根据 DeepSeek 提供的 API 调用文档进行介绍学习。网址为：https://api-docs.deepseek.com/zh-cn/

2、结合 API 文档的知识学习和代码实现

  知识点一： api 访问网站（ base_url 的参数）可以为 https://api.deepseek.com 或 https://api.deepseek.com/v1 没区别，都可以

  知识点二：model='deepseek-chat' 表示调用模型 DeepSeek-V3 ；model='deepseek-reasoner' 表示调用模型 DeepSeek-R1

  知识点三：stream=True 表示模型生成结果采用 流式 输出；stream=False 表示采用 非流式 输出。

流式输出即生成一个词，显示一个词；非流式输出表示模型生成完结果后，一次性显示出来

  知识点四：兼容 OpenAI 的 API 格式

2.1 简单例子

from openai import OpenAI
client = OpenAI(api_key="sk-123456", base_url="https://api.deepseek.com")

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "Hello"},
    ],
    stream=False
)
print(response.choices[0].message.content)

  解析：

• 用到 openai 库，使用 pip install openai 下载
• 注意：chat.completions.create() 函数与 completions.create() 函数是有区别的

chat.completions.create() 主要用于多轮对话，聊天机器人；使用模型：gpt-4、chatGPT。
completions.create() 主要用于单次文本生成、传统文本补全；使用模型：text-davinci-003。

---

chat.completions.create() 传递一个 messages 列表，每条信息需要指定角色：system、user、assistant，输出：response.choices[0].message.content。
completions.create() 传递一个 prompt 字符串，输出：response.choices[0].text。

---

优先使用 chat.completions.create() 模型，如果需要使用早期模型（text-davinci-003）或简单文本生成，可以使用 completions.create()

• role 一共有三种角色：system、user、assistant

system ：系统指令，由用户在对话开始时设定，比如：“你是一个翻译助手”。
user：用户的提问。
assistent：由模型生成的回答内容，同时可以记录信息，辅助模型理解上下文。

• model、messages、stream是同级的

  结果：

  其他参数（自己尝试一下）：

• print(response.id)：唯一标识符。
• print(response.created)：API响应生成的时间戳。
• print(response.model)：模型类型。
• print(response.object)：返回数据的对象类型。
• print(response.usage.completion_tokens)：模型生成的令牌数量。
• print(response.usage.prompt_tokens)：用户输入的令牌数量。
• print(response.usage.total_tokens)：总令牌数量。
• print(response.choices[0].index)：模型生成的索引。
• print(response.choices[0].message.role)：模型生成的角色。

2.2 Temperature 设置

  由 API 文档可知：temperature 默认为 1.0

  建议设置：

场景	温度
代码生成/数学解题	0.0
数据抽取/分析	1.0
通用对话	1.3
翻译	1.3
创意类写作/诗歌创作	1.5

2.3 其他补充

  模型和价格，Token 用量计算，限速，错误码没有列出，请自行查看，如果本文章能够火的话，将来可以补充。

  下一篇文章将深入介绍 API 文档中的使用部分。