DeepSeek API 怎么调用？零基础到第一次请求

30 秒了解：DeepSeek API 是什么

DeepSeek API 是 DeepSeek 提供给程序员的接口——通过 HTTP 请求把问题发给 DeepSeek 服务器，它把回答返回给你的代码。 跟你在网页 / App 上”自己用”DeepSeek 的区别只有一个：API 让你把 DeepSeek 嵌进自己的应用——做客服机器人、自动写文章工具、批量处理脚本等等。

适合人群：

想做带 AI 能力的小工具 / 自动化脚本
想批量处理大量内容（一次几百几千条）
已经在用 ChatGPT / Claude API，想换更便宜的国产替代

不适合：只是想日常聊聊天——直接用 DeepSeek 网页版就行。

下面把”从零到第一次成功请求”按顺序讲一遍。

准备工作

一个 DeepSeek 账号（手机号 / 邮箱注册即可）
一张能充值的银行卡 / 支付宝 / 微信（API 调用按 token 计费，要先充一点钱进去）
Python 或 Node.js 任一开发环境（这篇用 Python 演示）
一个文本编辑器（VS Code / Cursor 都行）

不需要懂”什么是 API”——跟着步骤走就行。

详细操作步骤

第 1 步：打开 API 平台并注册

DeepSeek 的 API 平台跟普通对话页是两个独立网站：

对话页：deepseek.com
API 平台：platform.deepseek.com

打开 platform.deepseek.com，用同一个手机号 / 邮箱登录（DeepSeek 主站和 API 平台账号体系互通）。

第 2 步：充值

API 是按用量收费的，必须先充一点余额进去。

进入 platform.deepseek.com 后：

左侧菜单找「充值 / Top Up」
选金额（建议先充最小金额体验，比如 10 元）
用支付宝 / 微信 / 银行卡支付

充进去之后右上角能看到账户余额。

注意：DeepSeek API 按 token 计费，token 价格在国产 API 里属于较友好档位，具体最新单价以官网公布为准。10 元一般够练习几百次普通请求。

第 3 步：创建 API Key

API Key 是你的”密码”——拿着它就能调用 API。

左侧菜单「API keys」
点「Create new API key」
给 key 起一个名字（比如”我的练手 key”）
复制下来保存好——这个 key 只显示一次，关掉就再也看不到

把它存到一个本地文本文件，命名 my_deepseek_key.txt 之类。永远不要把这个 key 发到 GitHub、贴到截图里、转给别人——拿到 key 等于拿到你的余额。

第 4 步：装好 Python 环境（已装跳过）

确认你电脑上有 Python：

打开终端（Mac 是「终端」App、Windows 是「PowerShell」），输入：

python3 --version

如果显示「Python 3.X.X」就有。没有的话去 python.org 下载安装。

然后装 openai 库（DeepSeek API 兼容 OpenAI SDK 格式，可以直接复用）：

pip3 install openai

第 5 步：写第一个 Python 请求

新建一个文件叫 hello_deepseek.py，把下面这段贴进去：

from openai import OpenAI

client = OpenAI(
    api_key="把你的_API_Key_粘到这里",
    base_url="https://api.deepseek.com"
)

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "你是一个会讲冷笑话的助手"},
        {"role": "user", "content": "讲一个关于程序员的冷笑话"}
    ],
    stream=False
)

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

把第 4 行的 api_key 换成你第 3 步保存的真实 key，保存。

第 6 步：运行

终端切到这个文件的目录，执行：

python3 hello_deepseek.py

等几秒，你应该看到 DeepSeek 返回的一个冷笑话。

恭喜，你已经成功调用了第一次 DeepSeek API。

如果报错，最常见的 3 个问题：① API Key 没贴对；② 余额不足；③ 网络访问 api.deepseek.com 不通。

5 个高级技巧

技巧 1：选用 deepseek-chat 还是 deepseek-reasoner

DeepSeek API 主要两个模型：

deepseek-chat = 对应网页上的 V3，通用、快、便宜
deepseek-reasoner = 对应网页上的 R1，会推理、贵、慢

代码里改 model="deepseek-chat" 或 model="deepseek-reasoner" 即可。

日常通用任务用 deepseek-chat，复杂推理 / 数学 / 代码用 deepseek-reasoner。详细差别看 DeepSeek V3 与 R1 区别。

技巧 2：用流式输出，让用户边等边看

把 stream=False 改成 stream=True，然后把打印改成：

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "user", "content": "写一个 200 字的童话故事"}
    ],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

效果是 DeepSeek 一边生成一边打印（像网页上看到的”打字机效果”），比等几秒一次性出完体验好得多。

技巧 3：用 system message 设角色

system 消息是给 AI 设定身份。同样问题，不同 system 出来差别巨大：

"你是一个严谨的法律顾问" → 答得正式、引法条
"你是一个会讲冷笑话的助手" → 答得轻松、抖包袱
"你是一个 5 岁孩子的妈妈" → 答得温柔、用生活化语言

写应用时system message 是最关键的设计——决定了 AI 的”人格”。

技巧 4：多轮对话怎么实现

API 是无状态的——每次请求 DeepSeek 不记得你上一次说了什么。要做多轮对话，每次把完整聊天记录都传过去：

messages = [
    {"role": "system", "content": "你是一个学英语的陪练"},
    {"role": "user", "content": "Hello"},
    {"role": "assistant", "content": "Hi! What's your name?"},
    {"role": "user", "content": "My name is Tom"}
]

response = client.chat.completions.create(model="deepseek-chat", messages=messages)

你自己用列表维护这个 messages，每轮把用户输入和 AI 回复都 append 进去。

技巧 5：用 JSON Mode 拿结构化数据

如果你想让 DeepSeek 返回严格的 JSON 格式（比如做提取任务），加上 response_format：

response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[
        {"role": "system", "content": "提取下面文字里的姓名和电话，输出 JSON"},
        {"role": "user", "content": "我叫张三，电话 13800138000"}
    ],
    response_format={"type": "json_object"}
)

返回的会是合法 JSON，你可以直接 json.loads(response.choices[0].message.content) 解析。

curl 命令版（不写 Python 也能试）

如果你只是想验证一下 API 能不能用，不想装 Python，用 curl 一行就能测：

📋 Prompt 模板

curl https://api.deepseek.com/chat/completions
-H “Content-Type: application/json”
-H “Authorization: Bearer 你的_API_KEY”
-d ’{ “model”: “deepseek-chat”, “messages”: [{“role”: “user”, “content”: “你好”}] }’

把 你的_API_KEY 换成真实 key，粘到终端回车。1-3 秒后你会看到 DeepSeek 返回的 JSON。

常见坑 + 解决办法

现象	原因	解决
401 Unauthorized	API Key 错了 / 失效	重新生成 key，检查复制粘贴有无多余字符
402 Insufficient Balance	余额不足	去 platform.deepseek.com 充值
503 Service Unavailable	DeepSeek 服务器临时过载	等几分钟重试
请求超时	网络问题 / response 太大	减小输出长度 / 加超时重试
中文乱码	编码设置问题	Python 加 `# -- coding: utf-8 --`
输出格式不稳定	prompt 没约束	加上「严格按 JSON 输出」/「只回答这 3 项」

一个实战案例：批量翻译 1000 条短文

假设你有 1000 条产品标题要从中文翻译成英文，手动复制粘贴要 1 小时，用 API 几分钟搞定。

import csv
from openai import OpenAI

client = OpenAI(api_key="你的_KEY", base_url="https://api.deepseek.com")

results = []
with open("titles.csv", "r", encoding="utf-8") as f:
    for row in csv.reader(f):
        cn = row[0]
        response = client.chat.completions.create(
            model="deepseek-chat",
            messages=[
                {"role": "system", "content": "你是电商翻译专家，把中文产品标题翻译成简洁的英文"},
                {"role": "user", "content": cn}
            ]
        )
        en = response.choices[0].message.content
        results.append([cn, en])
        print(f"翻译完: {cn} -> {en}")

with open("titles_translated.csv", "w", encoding="utf-8") as f:
    csv.writer(f).writerows(results)

这种”读文件 + 循环 API + 写结果”是 API 最常见的用法。你能用它做：

批量改写商品描述
批量分类客服工单
批量生成产品图文案
批量识别评论情感
批量从邮件提取关键信息

DeepSeek API 计费机制

API 按 token 计费，1 个中文字大约 1-2 个 token，1000 个汉字约 1500-2000 token。

收费有两块：

输入 token：你发给 DeepSeek 的字数
输出 token：DeepSeek 回给你的字数

输出 token 一般比输入 token 单价高几倍。控成本的核心是控输出长度——在 prompt 里写「答案不超过 100 字」就能省一大半钱。

详细看 DeepSeek 收费吗的 API 价格段。

DeepSeek API 还有「缓存命中折扣」——重复 prompt 的输入 token 大幅打折。如果你做的应用每次都用同一个长 system prompt，这能省不少。

进阶 / 下一步

DeepSeek 怎么用：日常对话用法
DeepSeek V3 与 R1 区别：API 选模型
DeepSeek 深度思考怎么用：reasoner 模型详解
DeepSeek Prompt 库：50 个 prompt 模板
DeepSeek 安全吗：企业场景合规分析
DeepSeek 官网：防钓鱼正版入口

常见问题

Q：DeepSeek API 跟 OpenAI API 兼容吗？

是的。DeepSeek 故意做成跟 OpenAI 接口格式兼容——已经用 OpenAI SDK 的代码，只要改 api_key 和 base_url 就能跑。

Q：能不能让 DeepSeek API 联网搜索？

API 本身不带联网搜索功能（网页和 App 上有，但 API 没有）。要联网，你得自己写代码：先调搜索引擎 API 拿结果，再把结果作为 context 喂给 DeepSeek。

Q：API 调用会被速率限制吗？

会，每秒 / 每分钟有上限。新账号上限较低，用量稳定后可以申请提升。具体看 platform.deepseek.com 的「Limits」页。

Q：能本地部署 DeepSeek 不用 API 吗？

可以。DeepSeek 完全开源，模型权重在 HuggingFace 公开。但本地跑需要至少几张专业 GPU，硬件成本远高于直接调 API。除非你有特殊需求（数据完全不出网 / 极大调用量），用 API 更划算。

Q：API 调用的对话内容会被用来训练吗？

DeepSeek API 一般有”是否参与训练”的合规选项，企业用户可以明确关闭。具体条款看 platform.deepseek.com 的服务协议。

Q：用 DeepSeek API 做的应用，能商用吗？

能。DeepSeek API 允许商业使用。但你的应用要遵守 DeepSeek 的服务条款（不能用来生成违法 / 违反公序良俗的内容），违反可能导致 API Key 被封。