DeepSeek API 的接口基址是 https://api.deepseek.com,兼容 OpenAI 格式,另有 Anthropic 格式(路径为 /anthropic)。调用前先到开放平台 platform.deepseek.com 申请 API Key。目前主力模型是 deepseek-flash(DeepSeek-V4.1-Flash)与 deepseek-v4-pro,按百万 tokens 计费,空闲时段价格为高峰时段的一半。 DeepSeek API Key 怎么申请与调用
- 在平台内创建 API Key(官方文档里对应「申请一个 API key」这一步);
- API Key 拿到后立刻妥善保存:它等同于账号凭证,不要硬编码进代码或提交到公开仓库;
- 确认账户有可用余额——余额为零时调用会直接返回 402,需要先去充值页面充值;
把 stream 设为 true 就切换成流式输出。官方同时给了 Python 与 Node.js 样例,都是直接用 OpenAI SDK,只把 base_url 指向 https://api.deepseek.com 即可。
如果你不想自己写代码,官方也提供了一批 Agent 工具的接入指南,Claude Code、GitHub Copilot、OpenCode 等可以把 DeepSeek 直接作为后端模型。以 Claude Code 为例,只需设置几个环境变量,其中关键两项是 ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic 和 ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>。 DeepSeek API 入口与文档在哪
先把三个完全不同、最容易被混成一个的地址分开:
- 文档站:api-docs.deepseek.com,查参数、看示例的地方,中文版在 /zh-cn/ 下;
- 开放平台:platform.deepseek.com,申请 API Key、充值、查用量都在这里,要动钱的都在这;
- 接口基址:https://api.deepseek.com,这是写进代码的地址,不是给人浏览的网页。
另外还有一个容易混淆的:chat.deepseek.com 是网页对话版,免费直接用,和 API 是两套计费体系。不想写代码就用它,要按量付费、接自己应用的才走 API。
文档站几个常用页的路径也一并给出,省得挨个找:模型与价格在 /zh-cn/quick_start/pricing,错误码在 /zh-cn/quick_start/error_codes,限速与并发在 /zh-cn/quick_start/rate_limit,Token 用量在 /zh-cn/quick_start/token_usage,版本沿革看 /zh-cn/updates。
官方入口只此几处,建议从官方页面直接进入,不要通过搜索引擎广告位或第三方下载站跳转;凡要求输入账号密码或支付信息的非官方页面都不要提交信息。
DeepSeek API 模型与价格对照
截至本文核查时间(2026 年 9 月),官方文档公示的模型参数如下:
两者都支持 JSON Output、Tool Calls、Responses API、Anthropic API 与对话前缀续写(Beta);FIM 补全(Beta)仅非思考模式支持。
价格以「百万 tokens」为单位,分空闲与高峰两个时段:
读这张表有三个要点。一是空闲时段价格是高峰时段的一半;高峰时段指北京时间周一至周五(不含中国法定节假日)的 9:00-12:00 与 14:00-18:00,其余时段包括周末和法定节假日全天都算空闲。二是输入价分「缓存命中」和「缓存未命中」两档,差距极大——flash 这两档相差 50 倍,多轮对话、同样上下文的重复调用尽量命中缓存,成本天差地别。三是文档站英文版按美元展示同一张表,中文页才是人民币口径,写进项目预算时别拿错币种。
DeepSeek API 的计费与扣费规则
官方给的是按量计费,口径写得很直白:扣减费用 = token 消耗量 × 模型单价,费用直接从账户余额里扣。
账户余额分两类:充值余额和赠送余额,官方规则是「当充值余额与赠送余额同时存在时,优先扣减赠送余额」,也就是赠金先用、充值金额后动。想知道自己账上各有多少,调一次余额接口即可:GET /user/balance 会返回 is_available(当前账户是否有余额可供调用)、total_balance(含赠金与充值余额的总可用余额)、granted_balance(未过期的赠金余额)和 topped_up_balance(充值余额)。
关于免费额度,这里要给一个明确结论:官方文档与官方 FAQ 都没有公示「注册赠送多少额度」的具体数额。核查依据是文档站全部页面与官方 FAQ 全文中,均未出现「免费额度」「赠送额度」「新用户」这类表述;但「赠送余额」作为一种余额类型确实存在(接口字段 granted_balance 的官方定义就是「未过期的赠金余额」)。所以是机制存在、数额未公开。想确认自己有没有赠金,注册后调一次 GET /user/balance,granted_balance 会把答案原样告诉你。
并发方面:并发限制以账号粒度计,与 API Key 无关,超过限度会返回 HTTP 429;如果确有更高并发需求,可以提交账号扩容申请工单,官方明确扩容不增加额外费用。
DeepSeek API 错误码速查
官方文档列出了以下 7 个错误码,其中与钱直接相关的是 402(余额不足)和 429(速率超限):
| | |
|---|
| | |
| | 检查 API Key 是否正确;还没有就去创建一个 |
| | |
| | |
| | |
| | |
| | |
另外两条容易踩的规则:一是官方明确计费按模型输入和输出的总 token 数计量,不按调用次数,觉得「调用次数少了费用却没降」时先看 token 用量;二是请求发出后如果 10 分钟内仍未开始推理,服务器会关闭连接。在同一账号下细分不同业务用户时,可以在请求里传 user_id 参数做隔离,它的格式要求是正则 [a-zA-Z0-9\-_]+、最长 512 字符,官方同时提醒不要在这个字段里放用户隐私信息。
DeepSeek API 常见问题(FAQ)
Q:DeepSeek API 怎么调用?
A:拿到 API Key 后,向 https://api.deepseek.com/chat/completions 发 POST 请求,请求头带 Authorization: Bearer <你的 Key>,请求体里指定 model 和 messages 即可。
Q:DeepSeek API 免费吗?
A:按量计费。官方文档与 FAQ 均未公示注册赠送的具体数额,账号里是否有赠金可调 GET /user/balance 看 granted_balance 字段。
Q:支持 OpenAI 格式吗?
A:兼容。base_url 用 https://api.deepseek.com,可以直接用 OpenAI SDK,只改 base_url 和 api_key。
Q:支持 Anthropic 格式吗?
A:支持。Anthropic 格式的 base_url 是 https://api.deepseek.com/anthropic,Claude Code 等工具就是通过它接入的。 Q:现在有哪些模型可用?
A:主力是 deepseek-flash(对应 DeepSeek-V4.1-Flash)与 deepseek-v4-pro(对应 DeepSeek-V4-Pro-0813),两者上下文都是 1M。
Q:怎么调用最省钱?
A:两件事——尽量安排在空闲时段跑(空闲价是高峰价的一半),以及让长上下文尽量命中缓存(输入缓存命中价远低于未命中价)。
Q:报 402 是什么原因?
A:账号余额不足。到开放平台确认余额并充值后即可恢复,余额为零时无法调用。
Q:报 429 怎么办?
A:说明请求速率(TPM 或 RPM)或并发达到了上限,先规划请求节奏;并发确实不够可提交扩容申请工单,官方明确扩容不额外收费。
Q:旧模型名还能继续用吗?
A:可以调用,但要注意:deepseek-v4-flash 与 deepseek-v4-flash-vision-exp 对应的模型已下线,请求会由 DeepSeek-V4.1-Flash 提供服务并按 Flash 价格计费,表面不报错、实际跑的已不是原来那个模型。
DeepSeek API 的模型、价格与计费规则会随官方调整,接入前在开放平台的文档站确认当期标准即可。想获取更多 DeepSeek API怎么调用 相关的模型更替与价格变化,可以关注本站的 AI 工具栏目,有新动态我们会同步更新。