如何完成DeepSeek API密钥设置（V4教程，2026）

您拥有DeepSeek账户，您想从自己的代码中调用API，但不确定要打开哪个控制台页面，使用哪个模型ID，或者`sk-…`字符串出现后该如何处理。本指南涵盖了DeepSeek API密钥设置的完整流程：创建平台账户、生成密钥、充值余额、安全存储密钥，并向`deepseek-v4-pro`或`deepseek-v4-flash`发送第一个`POST /chat/completions`请求。以下所有内容均于2026年4月24日——V4预览发布之日——与DeepSeek的实时平台和API文档进行了核对。到结束时，您将拥有一个有效的密钥、一个经过测试的Python和curl示例，以及您第一张发票的价格合理性检查。

深Seek API密钥究竟是什么

DeepSeek API密钥是一个携带令牌——一个以 sk- 开头的字符串——它用于验证对 https://api.deepseek.com的请求。 授权：Bearer YOUR_API_KEY 标头，以及错误的密钥或缺失密钥会导致401错误，如果您的余额耗尽，API将返回402。密钥在platform.deepseek.com/api_keys的平台上创建和撤销；仪表板还显示了您的余额、使用情况和账单历史。

有两点需要提前说明，因为这些可能会困扰从DeepSeek网页聊天迁移的开发者：

• The API is stateless. 网页应用会记住您的对话跨轮次。API不会——您的客户端必须重新发送完整的 messages array on every call.
• 当前的代号为DeepSeek V4，于2026年4月24日发布。它以两个开放重量的MoE模型ID发货： deepseek-v4-pro (1.6T total / 49B active parameters, frontier tier) and deepseek-v4-flash (284B / 13B 活跃，成本效益层)。两种权重都受MIT许可。您可以在请求时选择层，通过 model field.

如果您正在维护较旧的集成，则遗留ID目前仍然有效。模型名称deepseek-chat和deepseek-reasoner将于2026年7月24日被弃用，为了兼容性，它们分别对应于deepseek-v4-flash的非思考模式和思考模式。迁移操作只需一行代码。 model= 改变 —— base_url 保持不变。

Prerequisites

• 一个电子邮件地址（对于开发者账户推荐使用，比社交登录更稳定；它能在组织变更中存活）。
• 一种充值预付费余额的支付方式。该账户采用预付费信用模式，而不是每月发票计费。
• 如果您想运行快速入门代码片段，本地已安装Python 3.9+或Node.js 18+。
• 一个密钥管理器或至少一个gitignored文件。 .env 密钥绝不应该存放在应用程序源代码中。

深Seek API密钥设置步骤详解

1. 创建平台账户

Open platform.deepseek.com 在浏览器中。这是开发者控制台——与消费者聊天分开的独立界面。 chat.deepseek.com在首页，V4预览横幅确认该模型现在可在网页、应用程序和API上使用。使用电子邮件和强密码注册，通过确认电子邮件进行验证，然后登录。您将进入一个仪表板，显示使用情况、计费和密钥。

2. 充值账户余额

API将在账户上有信用余额或已授权余额之前不会发送请求。导航到侧边栏中的[4]，添加支付方式，然后购买信用。DeepSeek可能提供已授权余额——一种可能过期的少量促销信用，因此在充值之前请检查计费控制台中的当前优惠。费用将从您充值的余额或已授权余额中扣除，当两者都可用时，优先使用已授权余额。 Billing in the sidebar and add a payment method, then purchase credit. DeepSeek may offer a granted balance — a small promotional credit that can expire — so check the billing console for current offers before topping up. Fees are deducted from your topped-up balance or granted balance, with a preference for using the granted balance first when both balances are available.

探索性工作的合理首次充值金额为5-10美元。这可以为数十万个V4-V4 Flash请求或数千个V4-V4 Pro请求提供资金——足够用于原型设计。

3. 生成API密钥

在左侧侧边栏中，打开 API Keys。点击 创建新的API密钥，给密钥一个描述性的名称（例如 v4-prod-2026-04 or dev-scratchpad), 并确认。密钥字符串在模态中只出现一次。立即复制密钥——DeepSeek只会显示一次。如果您丢失了它，将无法找回；您需要撤销并重新生成。

避免后续痛苦的约定：

• 每个环境使用一个密钥—— dev, staging, prod ——这样您就可以撤销一个而不会影响其他密钥。
• 按日期标记以便轮换明显（v4-prod-2026-04).
• 永远不要将密钥提交到仓库，即使是私有的。CI日志会泄露；分叉事件会发生。

4. 安全存储密钥

两种可接受的模式：一个密钥管理器（AWS Secrets Manager、Google Secret Manager、1Password、Doppler、HashiCorp Vault）或本地 .env 列表中列出的 .gitignore文件。对于本地shell，导出它：

export DEEPSEEK_API_KEY="sk-..."

官方的OpenAI和DeepSeek SDK示例默认都从这个环境变量中读取，因此设置它意味着您的代码可以引用它而无需硬编码。

5. 发送第一个请求

Chat requests hit POST /chat/completions，与OpenAI兼容的端点。以下是从DeepSeek“首次API调用”文档中确认的最小curl调用——针对 deepseek-v4-pro 启用思考模式：

curl https://api.deepseek.com/chat/completions 
  -H "Content-Type: application/json" 
  -H "Authorization: Bearer ${DEEPSEEK_API_KEY}" 
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "thinking": {"type": "enabled"},
    "reasoning_effort": "high",
    "stream": false
  }'

Python的等效使用OpenAI SDK——DeepSeek API使用与OpenAI兼容的API格式，在实践中这意味着您可以通过更改基本URL为https://api.deepseek.com来经常重用OpenAI SDK或其他与OpenAI兼容的工具。

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="deepseek-v4-pro",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello"},
    ],
    reasoning_effort="high",
    extra_body={"thinking": {"type": "enabled"}},
)
print(response.选项[0].message.content)

成功的响应返回一个包含以下内容的JSON对象： 选项 数组，包含助手的消息和一个 usage 对象，包含令牌计数。在思考模式下，响应包含 reasoning_content alongside the final content。对于非思考模式——更快、更便宜——传递 extra_body={"thinking": {"type": "disabled"}}；省略它将使V4保持默认的启用思考模式。为了兼容性，https://api.deepseek.com/v1也受支持，但/v1路径不是模型版本指示符。

DeepSeek 同样在相同的基URL上提供与 Anthropic 兼容的表面，因此 Anthropic SDK 通过交换来工作。 base_url and api_key ——如果你的代码库已经使用它，这将很有用。

V4模型ID和思考模式

思考模式是 V4 模型上的一个请求参数，而不是一个单独的模型ID。接受的设置有：

• Non-thinking：V4默认启用思考模式；传递 extra_body={"thinking": {"type": "disabled"}} 用于非思考。最快，每请求最便宜。此模式还启用了 Beta 中的 FIM（中间填充）完成。
• Thinking (high)：设置 reasoning_effort="high" and extra_body={"thinking": {"type": "enabled"}}. 响应返回 reasoning_content alongside the final content.
• Thinking-max：设置 reasoning_effort="max". 最大推理努力；确保 max_tokens 足够高以避免截断。

新密钥应该针对哪个级别？

V4 Flash 是默认推荐。V4 Pro 的输出价格大约是 V4 Flash 的 12 倍，因此仅在基准提升（例如在代理编码或 Terminal-Bench 上）足以证明支出合理的情况下，将工作负载提升到 V4 Pro。

值得了解的核心参数

• temperature —— 随机性。DeepSeek 的自身指导：代码和数学为 0.0，数据分析为 1.0，一般对话和翻译为 1.3，创意写作为 1.5。
• top_p — 核心采样；设置此选项 or 温度，不要两者都设置。
• max_tokens —— 输出上限。在 V4 上，这可以达到 384,000 个标记。保持足够高，以便 JSON 模式下回复不会被截断。
• reasoning_effort — 仅V4；与上述显示的思考标志配对。
• stream — 设置 true 用于服务器发送事件分块。
• response_format={"type": "json_object"} — JSON模式。它是 designed 返回有效的JSON，不保证；提示包含单词“json”和一个小型示例模式，并设置 max_tokens high enough to avoid truncation.

两个V4层级默认都使用 1,000,000-token context window with output up to 384,000 tokens流式传输、工具调用、上下文缓存和Chat Prefix Completion（Beta）功能均可用。对于完整参数参考，请参阅 DeepSeek API documentation.

速率限制、错误及第一天预期情况

DeepSeek不发布每个键的固定QPS（每秒查询数）数字——限制与平台负载灵活调整，平台保留限制重击流的权利。构建防御性：

• 在429错误时进行重试，使用指数退避和抖动。
• 将401（无效或缺失密钥）和402（余额不足）错误视为不可重试的——它们需要操作员干预。
• 在计费控制台中设置软使用警报在60%和90%，以免批量作业耗尽余额时感到惊讶。

完整的错误分类法请参阅指南 DeepSeek API error codes.

定价合理性检查——实例演示

2026年4月的价格如下 官方DeepSeek定价页面:

峰值折扣已停止（截止日期2025-09-05）且未随V4版本返回。考虑一个现实的工作负载：1,000,000次调用，使用2,000个token缓存的系统提示，200个token未缓存的用户消息，以及300个token的响应。

On deepseek-v4-flash:

• Cached input: 2,000 × 1,000,000 = 2,000,000,000 tokens × $0.0028/M = $5.60
• Uncached input: 200 × 1,000,000 = 200,000,000 tokens × $0.14/M = $28.00
• Output: 300 × 1,000,000 = 300,000,000 tokens × $0.28/M = $84.00
• Total: $117.60

On deepseek-v4-pro, 相同工作量：

• Cached input: 2,000,000,000 × $0.003625/M (promo) = $7.25 （列表价29.00美元）
• Uncached input: 200,000,000 × $0.435/M (promo) = $87.00 （列表价348.00美元）
• Output: 300,000,000 × $0.87/M (promo) = $261.00 (列出 $1,044.00)
• Total: $355.25 (V4-V4 Pro 75% promo through 2026-05-31; list $1,421.00)

每条新用户消息在模型看到之前都会与缓存的前缀不匹配——即使系统提示缓存完美，未缓存的行也不会归零。对于实时计算器，请使用我们的 DeepSeek pricing calculator.

安全性：将密钥视为生产凭证

• 仅限服务器端。 永远不要在浏览器JavaScript、移动二进制文件或发送给用户的桌面应用程序中嵌入密钥。通过后端代理。
• 按计划旋转。 每季度至少一次是合理的；如果关键信息涉及客户数据，则每月一次。
• 在怀疑的情况下撤销。 任何出现在日志、截图或公共仓库中的密钥都已被泄露。请在控制台中撤销并重新生成。
• 扫描您的代码库。 GitGuardian、TruffleHog 和 GitHub 秘密扫描都能检测到该 sk- 模式。如果您的托管支持，请启用推送保护。
• 最小化发送的数据。 除非实际使用场景确实需要，否则请从提示中删除个人身份信息（PII）；对话在受中国法律约束的服务器上处理。

关于更深入的头部、密钥轮换和审计日志覆盖，请参阅配套文章 DeepSeek API authentication.

验证设置是否成功

1. 运行上面的 curl 或 Python 段落。200 响应表示 选项[0].message.content 字符串意味着密钥和计费都是活跃的。
2. 打开平台 使用 页面。一小笔扣除应在几分钟内显示，与 usage 响应中的对象。
3. 击中 GET /user/balance 使用相同的Bearer头部来程序化地确认剩余的信用额度。
4. 如果首次调用失败：401表示承载头错误，402表示余额不足，而找不到模型错误通常意味着存在拼写错误 model —— 正确的ID是 deepseek-v4-pro and deepseek-v4-flash.

要获取更全面的端到端入职流程演示以及示例项目，请参阅 DeepSeek API getting started，并探索更广泛的 DeepSeek API docs and guides 以了解流式传输、缓存和函数调用等主题。

DeepSeek AI Guide is an independent resource and is not affiliated with DeepSeek or its parent company. Model IDs, pricing and API behaviour change; check the official DeepSeek documentation and pricing page before committing to a production decision.