跳到主内容

DeepSeek API 完全上手:注册、实名、充值、建 Key,一篇走完

4337 字
22 分钟
DeepSeek API 完全上手:注册、实名、充值、建 Key,一篇走完

DeepSeek API 完全上手:注册、实名、充值、建 Key#

写这篇的原因很简单:几乎每个想在自己电脑上跑 AI Agent 的人,第一步都会卡在这里。

卡点通常不是「不会注册」,而是几件没人提前告诉你的事:

  • 没实名就不能充值,而没余额就调不了 API——顺序错了就是干等;
  • API Key 只显示一次,关掉弹窗就再也看不到,只能删了重建;
  • DeepSeek 是分时计价的,同样的用量,工作日白天跑和半夜跑,账单能差一倍;
  • 网页版聊天是免费的,API 是按量付费的,两者余额不通用——很多人以为充了钱网页版会变快。

这篇把整条链路一次讲完:注册 → 实名 → 充值 → 建 Key → 验证 → 算账。

本文的核实说明:平台界面文案、充值档位、价格分区以 2026-09-18 的公开信息为准,并已在文末列出核对来源。价格与界面会变,涉及金额的地方请以 platform.deepseek.com 实时公示为准。


一、开始之前:你需要准备什么#

项目说明
浏览器Chrome / Edge / Safari 均可,建议在电脑上操作(实名认证要填证件信息,手机端容易误触)
账号一个可收短信的手机号,或微信账号
证件个人认证需要二代身份证;企业认证需要营业执照等材料
支付方式支付宝或微信支付(也支持对公汇款)
预算首次充 ¥10 就够跑通全流程,不用一上来充几百

一句重要提醒:DeepSeek 的网页版和手机 App 是免费的,充值只影响 API 调用。如果你只是想聊天,不需要看这篇。


二、注册与登录#

第 1 步:打开开放平台#

浏览器访问:

https://platform.deepseek.com

注意别走错门——chat.deepseek.com 是给人聊天用的网页版,platform.deepseek.com 才是开发者控制台。API Key、充值、账单、用量都在后者。

🖼️ 配图占位 · 1-1:platform.deepseek.com 登录页。要拍出「手机号 / 微信扫码」两个登录入口,以及页面右侧的「API 开放平台」字样,用来和第 1 步的文字对上。

第 2 步:注册并登录#

在登录页选择其中一种方式完成注册/登录:

  • 手机号 + 短信验证码(推荐,后面实名认证也用同一个号);
  • 微信扫码。

登录成功后,你会看到左侧菜单栏。接下来所有操作都在这几个菜单里完成:

左侧菜单用途
用量信息看余额、看每天消耗了多少 Token
API keys创建 / 删除 API 密钥
充值(Top up)充值,含在线充值与对公汇款
账单(Billing)查充值记录与消费明细
接口文档模型 ID、调用方式、参数说明
产品定价官方实时价格表
常见问题官方 FAQ

建议你现在就点开「产品定价」看一眼——后面第三节算账时会用到,而且这是唯一权威的价格来源。

🖼️ 配图占位 · 1-2:登录后的控制台首页,把左侧完整菜单栏拍进去。这张图能省掉后面至少三次「我该点哪里」的疑问。


三、实名认证:绕不过去的一步#

这是最容易踩的坑,所以单独拎出来讲。

关键事实#

未完成实名认证,无法充值。 充值页会直接拦住你,提示需要先完成认证。

而 API 调用需要账户余额大于 0。所以正确的顺序是:

注册 → 实名认证 → 充值 → 创建 API Key

很多人把「创建 API Key」放在最前面做(因为看起来最像技术步骤),结果卡在充值那一步,又回头找实名入口。

认证步骤#

  1. 左侧菜单点击 「充值」;
  2. 页面会提示需要完成实名认证,点击 「Verify / 去认证」;
  3. 选择认证类型:
    • Individual(个人):开发者个人使用,选这个;
    • Enterprise(企业):需要用企业主体,材料更多;
  4. 填写信息:
    • Real Name(真实姓名):仅限中文,必须与身份证完全一致;
    • Type of ID(证件类型):默认「二代身份证」;
    • ID Number(身份证号):逐位核对,别用 OCR 复制,容易把 0/O、1/l 认错;
  5. 勾选同意服务条款,点击 「Submit」 提交。

提交之后#

按页面提示等待审核结果。审核期间可以先去把 API Key 建好(见第五节),不冲突。

如果认证被打回,通常是这三个原因:

现象原因处理
姓名校验不通过用了英文名、拼音,或姓名含空格必须填中文真实姓名,与证件完全一致
身份证号不匹配号码与姓名不一致,或末位 X 大小写 / 全角半角问题逐位核对;末位 X 用大写半角
反复失败网络或页面缓存问题换浏览器、清缓存后重试;仍不行走官方 FAQ 里的反馈入口

🖼️ 配图占位 · 1-3:实名认证表单页。拍出「Individual / Enterprise」选项和「Real Name(仅限中文)」的输入提示——这两处是打回率最高的地方。


四、充值#

认证通过后,回到充值页。

第 1 步:选择金额#

在线充值页面提供固定档位,也可以自定义:

¥10 ¥20 ¥50 ¥100 ¥300 ¥500 自定义

自定义金额有上下限,页面会实时提示(例如「请输入 1 元至 xxx 元之间的金额」)。以页面提示为准,不要按第三方教程里的数字填。

第 2 步:选择支付方式#

  • 支付宝(ALIPAY)
  • 微信支付
  • 大额或报销需求可以走 对公汇款

选好后点「去支付 / Next step」,完成付款。

第 3 步:确认到账#

付款成功后回到「账单」页面,可以看到这笔充值记录。余额在「用量信息」页面查看。

充值余额不过期,用多少扣多少。所以充多充少主要影响的是「要不要经常回来充」,而不是「会不会浪费」。

首次建议:充 ¥10–¥20。按第六节的测算,这足够一个轻度使用的 Agent 跑很久,也够你在踩坑阶段随便试。

🖼️ 配图占位 · 1-4:充值页。要同时拍到金额档位、自定义输入框、支付宝/微信支付两个选项,以及页面顶部那句「先完成实名认证之后才能充值」的提示。


五、创建 API Key#

这一步产出的是你后面所有工具都要用的东西,请认真对待。

第 1 步:进入 API keys 页面#

左侧菜单 → 「API keys」。

第 2 步:创建#

点击右上角/页面的 「Create new API key」(或「创建 API key」)按钮,在弹出的对话框里填一个名称。

命名建议(这一步随手做,后面省很多事):

openclaw-mac-20260918

规律是 用途 + 机器 + 日期。好处有两个:

  • 哪台机器/哪个工具在用,一眼看出来;
  • 万一泄露,删掉这一把就行,不影响其他工具。

建议一把 Key 对应一个环境,不要所有工具共用一把。

第 3 步:复制并保存 —— 只有这一次机会#

⚠️ API Key 只显示一次。 弹窗关闭后无法再次查看。忘了复制,只能删掉重建。

弹窗出现后:

  1. 点击 「Copy」;
  2. 立刻粘贴到一个安全的地方(密码管理器 / 备忘录,不要丢进聊天窗口或 Git 仓库);
  3. 确认粘贴完整:以 sk- 开头,前后没有空格、没有换行——从网页复制时最容易带进一个换行符,这会让后面所有调用都报 401。

🖼️ 配图占位 · 1-5:API Key 创建弹窗。把输入名称的输入框、Create 按钮,以及密钥显示区域一起拍进来。

🖼️ 配图占位 · 1-6:Key 列表页。拍出「名称 + 创建时间 + 删除按钮」的列表结构,说明之后想换 Key 就在这里操作。


六、验证 Key 是否可用#

别跳过这一步。 先确认 Key 本身没问题,之后接入任何工具时出问题,你就能立刻排除「Key 是不是坏了」这个变量。

方法一:curl(最快)#

打开终端(macOS:⌘ + 空格 输入 Terminal 回车),粘贴:

Terminal window
export DEEPSEEK_API_KEY="sk-你的密钥"
curl https://api.deepseek.com/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DEEPSEEK_API_KEY}" \
-d '{
"model": "deepseek-v4-flash",
"messages": [{"role": "user", "content": "只回复两个字:收到"}],
"stream": false
}'

期望结果:返回一段 JSON,里面有 choices[0].message.content(内容应该是「收到」),以及 usage 字段(本次消耗的 Token 数)。

usage 里三个数字要认识一下:

字段含义
prompt_cache_hit_tokens输入中命中缓存的 Token(最便宜,0.02 元/百万)
prompt_cache_miss_tokens输入中未命中缓存的 Token(1 元/百万)
completion_tokens输出 Token(4 元/百万,最贵)

后面第六节算账时,这三个数字就是你的实际账单结构。

方法二:Python(如果你要写脚本)#

import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["DEEPSEEK_API_KEY"],
base_url="https://api.deepseek.com",
)
resp = client.chat.completions.create(
model="deepseek-v4-flash",
messages=[{"role": "user", "content": "只回复两个字:收到"}],
)
print(resp.choices[0].message.content)

DeepSeek 提供 OpenAI 兼容接口,所以已有的 OpenAI SDK、LangChain、各种 Agent 框架,通常只需要把 base_url 改过来就能用。

关于地址和模型 ID#

项目值
Base URLhttps://api.deepseek.com(兼容写法:https://api.deepseek.com/v1)
对话接口POST /chat/completions
Flash 系列模型 IDdeepseek-flash(旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp,仍接受但已退役)
旗舰模型 IDdeepseek-v4-pro

关于「V4.1」这个叫法:社区里常见「DeepSeek V4.1 Flash」这样的名字,但填配置时要用官方模型 ID deepseek-flash(旧名 deepseek-v4-flash 仍被接受,但已退役、由 V4.1-Flash 承接)。手写成 deepseek-v4.1-flash 会直接报模型不存在(实测报错:The supported API model names are deepseek-flash, deepseek-v4-pro, but you passed deepseek-v4.1-flash.)。

模型 ID 会随版本变化。最可靠的确认方式是看控制台左侧的「接口文档」,或直接请求模型列表接口(OpenAI 兼容):GET https://api.deepseek.com/models。以实际返回为准。

🖼️ 配图占位 · 1-7:终端里 curl 成功返回的完整 JSON。框出 choices、usage.prompt_cache_hit_tokens、usage.completion_tokens 三处,与上面的说明对应。


七、价格、分时与真实费用测算#

当前价格(Flash 系列)#

2026-09-10 12<00> 起,DeepSeek 调整了 Flash 系列的计费价格,继续采用峰谷分时机制:

计费项闲时高峰(闲时 ×2)
输入(缓存命中)0.02 元 / 百万 Token0.04 元 / 百万 Token
输入(缓存未命中)1 元 / 百万 Token2 元 / 百万 Token
输出4 元 / 百万 Token8 元 / 百万 Token

高峰时段:工作日(周一至周五)9<00>–12<00> 与 14<00>–18<00>(北京时间)。 其余时间全部是闲时——包括工作日的午休、晚上、以及整个周末。

Flash 系列包含 deepseek-v4-flash 与 deepseek-v4-flash-vision-exp 两个模型,价格一致。定位更高的 deepseek-v4-pro 本次未调价,单价不同,不要拿 Flash 的价目表去估 Pro 的账单。

先把最大的杠杆找出来#

上面这张表里藏着一个 50 倍的差距:

输入(缓存命中) 0.02 元/百万
输入(未命中) 1.00 元/百万 ← 相差 50 倍

也就是说,「让模型复用已缓存的前缀」比「换个更便宜的模型」重要得多。在 Agent 场景里,系统提示词、工具定义、工作区文件这些内容每轮都重复发送——只要它们被缓存命中,这部分成本就几乎可以忽略。

实操上的含义:

  • 保持对话上下文结构稳定(不要每轮都改动系统提示词的开头);
  • 别频繁新开会话——缓存需要在同一个会话前缀上才容易命中;
  • 反过来,如果会话已经很长、内容已经完全不相关,那该新开就新开,避免未命中部分白花钱。

混合均价怎么算#

只给一个「xx 元/百万 Token」的结论没有意义,因为你的实际用量结构决定了均价。下面给一个可替换参数的算法,你可以按自己的情况改。

假设一次典型 Agent 用量的结构是:

参数取值
输入占比70%
输出占比30%
输入缓存命中率80%

那么每消耗 100 万 Token(合计):

输入 70 万 Token
├─ 命中 80% = 56 万 × 0.02 元/百万 = 0.0112 元
└─ 未命中 20% = 14 万 × 1 元/百万 = 0.14 元
输出 30 万 Token
└─ 30 万 × 4 元/百万 = 1.2 元
合计 ≈ 1.35 元 / 百万 Token(闲时)

换个缓存命中率,结论差多少#

这是最值得你自己动手算一遍的地方(按同样的 70/30 结构):

缓存命中率闲时混合均价¥10 能买到高峰混合均价¥10 能买到
95%≈ 1.28 元/百万≈ 780 万 Token≈ 2.55 元/百万≈ 390 万 Token
80%(本文基准)≈ 1.35 元/百万≈ 740 万 Token≈ 2.70 元/百万≈ 370 万 Token
50%≈ 1.56 元/百万≈ 640 万 Token≈ 3.12 元/百万≈ 320 万 Token
0%(完全不命中)≈ 1.90 元/百万≈ 530 万 Token≈ 3.80 元/百万≈ 260 万 Token

这张表想说明两件事:

  1. 分时的影响比命中率更直观。同样的钱,全部挪到闲时跑,能多买约一倍的量。
  2. 输出 Token 才是大头。哪怕缓存完全不命中,均价也只从 1.28 涨到 1.90 元——但如果你的任务输出量大(比如长篇生成),结论会完全不同:纯输出是 4 元/百万,是命中输入的 200 倍。

所以对「让 AI 少说废话」这件事,省钱效果是实打实的。

粗略的月度参考#

按上面的基准结构,把 Token 消耗换算成金额:

使用强度月 Token 量(示意)闲时月成本
轻度(每天问几句)500 万≈ ¥7
中度(日常 Agent 助手)3000 万≈ ¥40
重度(长时间跑 Agent 任务)1 亿≈ ¥135

注意:上表是「闲时 + 80% 缓存命中 + 70/30 结构」三个假设同时成立的结果。任一条不成立,成本都会往上走。想对账,去控制台「用量信息」页面看实际数字,那里是唯一准的。

🖼️ 配图占位 · 1-8:控制台「用量信息」页面。拍出余额、当日/当月消耗曲线,以及可选的按模型拆分视图。


八、密钥安全:三条底线#

API Key 等同于你的钱包。 泄露的直接后果是余额被刷光,而且账单是你的。

  1. 不要提交到 Git。公开仓库不用说,私有仓库也不行——CI 日志会泄露,仓库会 fork。 给项目加 .gitignore:
    .env
    .env.local
  2. 不要发到任何聊天窗口。包括群聊、包括发给 AI 助手。要传给工具,粘贴到工具的配置界面里。
  3. 用环境变量或配置界面,不要在代码里硬编码。
    Terminal window
    export DEEPSEEK_API_KEY="sk-..."

怀疑泄露时的处理:立刻去「API keys」页面删除那把 Key,然后重建一把——删除是立即生效的。别忘了同步更新所有用到它的工具(否则那些工具会一直报 401)。

🖼️ 配图占位 · 1-9:API keys 列表页,把每行的删除按钮高亮出来,说明「怀疑泄露时点这里」。


九、常见报错对照表#

调用失败时,先在这里对一下错误码,能解决八成问题。

报错含义排查顺序
401 Authentication Fails密钥无效① Key 是否完整复制(sk- 开头、无空格换行);② 该 Key 是否已被删除;③ 重建过 Key 但工具里还是旧的;④ 实名/账号状态是否正常
Insufficient balance / 余额不足账户没钱了去「充值」页面充值;注意网页版免费不影响 API,API 必须有钱
Model not found / Invalid model模型 ID 写错用 deepseek-v4-flash;到「接口文档」或 /models 接口核对当前有效 ID
429 Too Many Requests触发限流等几十秒重试;检查是否多个任务在同时高频调用;降并发
400 Bad Request请求体格式问题检查 JSON 是否合法、messages 结构是否正确、model 是否在列表内
503 / 服务器繁忙服务端压力稍后重试;高峰时段更常见,可考虑错峰

一条通用排查法:拿第六节的 curl 命令单独跑一次。

  • curl 能通、但你的工具报错 → 问题在工具的配置里(地址、模型 ID、Key 粘贴);
  • curl 也报错 → 问题在账号或 Key 本身。

这一条能帮你把问题域砍掉一半。


十、下一步#

拿到可用的 sk- Key 之后,你可以:

  • 接入 OpenClaw(桌面菜单栏 AI 助手)→ 见《安装与配置 OpenClaw》
  • 接入 Hermes 桌面版 → 见《安装与配置 Hermes 桌面版》
  • 或者直接写脚本调 API

不管接哪个工具,都建议先把这篇第六节的 curl 验证跑通,再去配置工具——这样出问题时你能立刻分清是「Key 的问题」还是「工具的问题」。


核对来源#

价格、界面文案、模型 ID 均可能随版本变化。涉及金额与模型 ID 的地方,一律以控制台实时显示为准。

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!

打赏
作者
AWF
发布于
2026-09-18
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
AWF
Hello, I'm AWF.
公告
欢迎来到我的博客!
探索发现
最新动态
站点统计
文章
30
分类
3
标签
50
总字数
137,731
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Local
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录