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」放在最前面做(因为看起来最像技术步骤),结果卡在充值那一步,又回头找实名入口。
认证步骤
- 左侧菜单点击 「充值」;
- 页面会提示需要完成实名认证,点击 「Verify / 去认证」;
- 选择认证类型:
- Individual(个人):开发者个人使用,选这个;
- Enterprise(企业):需要用企业主体,材料更多;
- 填写信息:
- Real Name(真实姓名):仅限中文,必须与身份证完全一致;
- Type of ID(证件类型):默认「二代身份证」;
- ID Number(身份证号):逐位核对,别用 OCR 复制,容易把 0/O、1/l 认错;
- 勾选同意服务条款,点击 「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 只显示一次。 弹窗关闭后无法再次查看。忘了复制,只能删掉重建。
弹窗出现后:
- 点击 「Copy」;
- 立刻粘贴到一个安全的地方(密码管理器 / 备忘录,不要丢进聊天窗口或 Git 仓库);
- 确认粘贴完整:以 sk- 开头,前后没有空格、没有换行——从网页复制时最容易带进一个换行符,这会让后面所有调用都报 401。
🖼️ 配图占位 · 1-5:API Key 创建弹窗。把输入名称的输入框、Create 按钮,以及密钥显示区域一起拍进来。
🖼️ 配图占位 · 1-6:Key 列表页。拍出「名称 + 创建时间 + 删除按钮」的列表结构,说明之后想换 Key 就在这里操作。
六、验证 Key 是否可用
别跳过这一步。 先确认 Key 本身没问题,之后接入任何工具时出问题,你就能立刻排除「Key 是不是坏了」这个变量。
方法一:curl(最快)
打开终端(macOS:⌘ + 空格 输入 Terminal 回车),粘贴:
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 osfrom 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 URL | https://api.deepseek.com(兼容写法:https://api.deepseek.com/v1) |
| 对话接口 | POST /chat/completions |
| Flash 系列模型 ID | deepseek-flash(旧名 deepseek-v4-flash、deepseek-v4-flash-vision-exp,仍接受但已退役) |
| 旗舰模型 ID | deepseek-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>00> 起,DeepSeek 调整了 Flash 系列的计费价格,继续采用峰谷分时机制:
| 计费项 | 闲时 | 高峰(闲时 ×2) |
|---|---|---|
| 输入(缓存命中) | 0.02 元 / 百万 Token | 0.04 元 / 百万 Token |
| 输入(缓存未命中) | 1 元 / 百万 Token | 2 元 / 百万 Token |
| 输出 | 4 元 / 百万 Token | 8 元 / 百万 Token |
高峰时段:工作日(周一至周五)9<00>00>–12<00>00> 与 14<00>00>–18<00>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 |
这张表想说明两件事:
- 分时的影响比命中率更直观。同样的钱,全部挪到闲时跑,能多买约一倍的量。
- 输出 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 等同于你的钱包。 泄露的直接后果是余额被刷光,而且账单是你的。
- 不要提交到 Git。公开仓库不用说,私有仓库也不行——CI 日志会泄露,仓库会 fork。
给项目加 .gitignore:
.env.env.local
- 不要发到任何聊天窗口。包括群聊、包括发给 AI 助手。要传给工具,粘贴到工具的配置界面里。
- 用环境变量或配置界面,不要在代码里硬编码。
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 的问题」还是「工具的问题」。
核对来源
- DeepSeek 开放平台:https://platform.deepseek.com
- DeepSeek 官方调价公告(2026-09-10 12<00>00> 生效,Flash 系列闲时 0.02 / 1 / 4 元,高峰双倍):IT之家 / 凤凰科技 https://tech.ifeng.com/c/8wGnh6n9f1z
- AIBase 英文版公告(含两代价格对比与降幅):https://www.aibase.com/news/30913
- DeepSeek API Key 创建与控制台流程(V4 走查):https://deepseekai.guide/api/deepseek-api-key-setup
- 充值页与实名认证前置规则实测记录(知乎/公众号整理稿,已与官方页面提示交叉验证)
价格、界面文案、模型 ID 均可能随版本变化。涉及金额与模型 ID 的地方,一律以控制台实时显示为准。
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!
