DeepSeek API 的官方文档站是 api-docs.deepseek.com,站内提供中文版(路径 /zh-cn/)。接口兼容 OpenAI 与 Anthropic 两种格式,base_url 分别是 https://api.deepseek.com 和 https://api.deepseek.com/anthropic;当前主力模型为 deepseek-flash 与 deepseek-v4-pro,上下文长度 1M。申请 Key、充值和查用量都在开放平台 platform.deepseek.com 完成。 DeepSeek API文档的官方入口
DeepSeek 的开发者相关入口按用途分成四处,别混用:
- API 文档站(查参数看这里):api-docs.deepseek.com。英文版在根路径,中文版在 /zh-cn/ 下,内容一致。站内按「快速开始 / API 参考 / 指南 / 新闻 / 更新日志」组织,共 70 多个页面。
- 开放平台(申请 Key、充值、查用量):platform.deepseek.com。API Key 在这里创建,余额与用量也在这里看。
- 接口基址(写进代码的地址):OpenAI 格式用 https://api.deepseek.com;Anthropic 格式用 https://api.deepseek.com/anthropic。注意这是接口地址,不是给人浏览的网页。
- 网页对话版(不想写代码就用这个):chat.deepseek.com。它和 API 是两套计费,网页版免费使用,API 按 token 单独计费。
注意区分:文档站只讲怎么调,真正要动钱的"申请 Key、充值"都在开放平台;而主站 www.deepseek.com 是公司官网,不放接口文档。认准 api-docs.deepseek.com 与 platform.deepseek.com 这两个即可。
怎么获取API Key并完成首次调用
官方给出的接入流程是四步:
- 注册并登录开放平台:打开 platform.deepseek.com,完成注册登录。
- 创建 API Key:在平台内创建密钥,复制后立即妥善保存——这类密钥通常只在创建时完整显示一次,丢失只能删除重建。
- 先把账户充上值:DeepSeek API 是预付费制,余额为零时调用会直接返回 402 而不是排队等待,所以首次调用前记得充值。
- 改一行配置就能跑:因为接口兼容 OpenAI / Anthropic 格式,把 OpenAI SDK 的 base_url 改成 https://api.deepseek.com、api_key 换成你的密钥、model 填 deepseek-flash,官方样例代码即可直接运行。
官方最简调用示例(curl):
- 请求地址:https://api.deepseek.com/chat/completions
- 请求头:Content-Type: application/json 与 Authorization: Bearer ${DEEPSEEK_API_KEY}
- 请求体关键字段:model(如 deepseek-flash)、messages、stream(false 为非流式);开启思考模式时加 thinking 与 reasoning_effort
如果你用的是 Claude Code、GitHub Copilot、OpenCode 这类现成工具,文档站的「Agent 工具接入」栏目给每个工具都写了配置页,不用自己写代码;官方另有一个面向开发者的 DeepSeek Harness 预览版可以关注。 DeepSeek当前模型与规格
当前可用的主力模型有两个,规格差异主要在图像理解能力上(数据来自官方「模型 & 价格」页):
| | |
|---|
| | |
| | |
| | |
| | |
| | |
| | |
Json Output / Tool Calls / Responses API / Anthropic API | | |
| | |
有一条容易踩的坑写在官方脚注里:旧模型名 deepseek-v4-flash 与 deepseek-v4-flash-vision-exp 现在仍然能调用,但对应的模型已经下线,请求会被路由到 DeepSeek-V4.1-Flash,并按 Flash 的价格计费。也就是说代码不报错、跑得通,但实际服务的已经不是你以为的那个模型——升级前先确认自己写的是不是现役模型名。
DeepSeek API的价格与计费规则
API 按 token 数量计费,单价以"每百万 tokens"为单位。价格分时段,也分缓存命中与否,具体如下(人民币,官方中文定价页口径):
读懂这张表要知道三条规则:
- 空闲时段价格是高峰时段的一半。 高峰时段为北京时间周一至周五(不含中国法定节假日)9:00–12:00 与 14:00–18:00;其余时段全算空闲,包括周末与法定节假日全天——批量任务挪到夜间或周末跑,费用直接减半。
- 缓存命中与未命中差几十倍。 flash 的输入价在两个档位之间相差 50 倍,所以长上下文、重复系统提示这类场景,命中缓存能省下大头;反过来,全是新鲜输入的任务不要按命中价去估成本。
- 扣减费用 = token 消耗量 × 模型单价,只按总 token 数计费、不按调用次数。账户同时有充值余额和赠送余额时,优先扣减赠送余额。
并发方面,flash 的账号级并发上限是 2500、v4-pro 是 500;并发按账号粒度计算,和你建了几个 API Key 无关,超出会返回 429。如果确实不够用,官方支持提交扩容申请,且扩容不额外收费。
DeepSeek API常见错误码速查
官方错误码共 7 条,按"先查钱、再查格式"的顺序用最快:
| | |
|---|
| | |
| | 去开放平台的充值页补上余额,这是"看着像接口坏了其实没钱"的典型 |
| | 降低发送频率,或等并发释放;官方也建议临时切换到其他厂商的 API 应急 |
| | |
| | |
| | |
| | |
另外官方还提供 GET /models 接口,可以直接列出当前账号可用的模型,用来核对模型名是否现役,比翻公告快。
DeepSeek API文档常见问题
Q:DeepSeek API 文档的官方地址是什么? A:文档站是 api-docs.deepseek.com,中文版在 /zh-cn/ 路径下;申请 Key 与控制台在 platform.deepseek.com。
Q:base_url 应该填哪个? A:用 OpenAI 格式填 https://api.deepseek.com,用 Anthropic 格式填 https://api.deepseek.com/anthropic。
Q:现在有哪些模型可用? A:主力是 deepseek-flash(对应 DeepSeek-V4.1-Flash,支持图像理解)与 deepseek-v4-pro(不支持图像理解),上下文长度均为 1M。
Q:deepseek-v4-flash 还能用吗? A:能调用但不建议依赖。官方写明该模型已下线,请求会被路由到 DeepSeek-V4.1-Flash 并按 Flash 价格计费,建议直接改用 deepseek-flash。
Q:调用报 402 是什么意思? A:账户余额不足。DeepSeek API 属于预付费,需要先在开放平台充值再调用。
Q:什么时候调用最便宜? A:空闲时段价格是高峰价的一半。避开北京时间工作日 9:00–12:00 与 14:00–18:00,把批量任务放到夜间或周末更划算。
Q:费用是按调用次数还是按 token 算? A:按 token 算,扣减费用 = token 消耗量 × 模型单价,与调用次数无关;输入分缓存命中与未命中两档计价。
Q:为什么用旧模型名不报错,结果却不对? A:因为旧名被路由到了新模型。想确认实际服务的模型与可用清单,可以用 GET /models 接口,或直接对照文档站的模型页。
Q:中文和英文分别大概多少个字算一个 token? A:官方给出的估算约为 1 个英文字符约合 0.3 token、1 个中文字符约合 0.6 token;精确用量以接口返回的 usage 字段为准,官方也提供离线分词器可自行计算。
DeepSeek 的模型清单、价格与限速规则会随版本调整,动手写代码前先在文档站确认当期参数与价格即可。想持续跟进 DeepSeek API文档 这类接口文档的最新入口与参数变化,可以关注本站的 AI 工具栏目,有更新我们会同步整理。