摘要：DeepSeek API 兼容 OpenAI 和 Anthropic 的接口格式，用现成的 OpenAI SDK 改一下 base_url 就能调用。本文按 2026 年 9 月的官方文档，讲清怎么申请 API Key、Python 最小调用示例、模型名怎么选、按 token 计费怎么看，以及 Key 的安全保管。

本文按 DeepSeek 官方文档 2026 年 9 月的版本编写。模型名和价格经常调整，动手前请对照官方文档。

先看官方给的三个参数

DeepSeek API 使用与 OpenAI / Anthropic 兼容的格式。用 OpenAI SDK 调用时，只要改两个地方：base_url 和 api_key。

DeepSeek API 入门：申请 Key、用 Python 调用、查看用量与计费-有序
DeepSeek API 文档“首次调用 API”页面截图：OpenAI 格式的 base_url 为 https://api.deepseek.com，模型名为 deepseek-flash 和 deepseek-v4-pro
参数值
base_url（OpenAI 格式）https://api.deepseek.com
base_url（Anthropic 格式）https://api.deepseek.com/anthropic
modeldeepseek-flash、deepseek-v4-pro

官方说明：旧模型名 deepseek-v4-flash 仍然可以调用，但会由新的 Flash 模型提供服务，并按 Flash 的价格计费。新项目直接用 deepseek-flash。

1. 申请 API Key

  1. 打开 DeepSeek 开放平台，用手机号或邮箱注册登录。
  2. 按平台提示完成充值（API 按用量付费，和网页版、App 的免费对话是分开的）。
  3. 进入“API keys”页面，点“创建 API key”，起一个能认出用途的名字。
  4. Key 只显示一次，马上复制保存。

2. 把 Key 放进环境变量

不要把 Key 写死在代码里，更不要提交到 GitHub。

macOS / Linux：

export DEEPSEEK_API_KEY="你的key"

Windows PowerShell：

$env:DEEPSEEK_API_KEY="你的key"

3. Python 最小示例

先安装 OpenAI SDK：

pip3 install openai

然后运行：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("DEEPSEEK_API_KEY"),
    base_url="https://api.deepseek.com",
)

resp = client.chat.completions.create(
    model="deepseek-flash",
    messages=[
        {"role": "system", "content": "你是一个简洁的中文助手。"},
        {"role": "user", "content": "用三句话解释什么是 API。"},
    ],
    stream=False,
)
print(resp.choices[0].message.content)

官方示例里还演示了用 thinking 参数开启思考模式、用 reasoning_effort 调节思考强度。要看到逐字输出的效果，就把 stream 设为 True。

4. 不写代码也能用

官方文档列出了已经适配 DeepSeek 的 Agent 和编程工具，如 Claude Code、OpenCode 等，在这些工具里把后端换成 DeepSeek 即可。另外，支持“OpenAI 兼容接口”的客户端（各种聊天客户端、翻译插件）一般也能直接填 base_url 和 Key 使用。

5. 计费怎么看

  • API 按 token 计费，输入和输出分开计价。token 可以粗略理解为字词片段，中文一个字大约对应一个左右的 token，具体以官方的《Token 用量计算》为准。
  • 不同模型价格不同。开启思考模式时，思考过程也会产生输出 token。
  • 当前价格见官方《模型 & 价格》页面；实际消耗在开放平台的“用量信息”里按天查看。

省钱小技巧：

  1. system 提示词写短一点，因为每次请求都会重复计费。
  2. 用 max_tokens 限制输出长度。
  3. 批量任务先用少量样本试跑，估算成本后再全量跑。

6. Key 的安全

  • 一个项目一个 Key，泄露时只删那一个。
  • 前端网页、小程序里不能直接放 Key，要经过自己的后端转发。
  • 在平台设置用量提醒，发现异常消耗马上删除 Key。

常见错误

现象可能原因
401Key 错误，或者没有读到环境变量
402余额不足
429请求太频繁，稍后重试并降低并发
模型不存在模型名写错，对照官方文档

相关阅读