Skip to content
AI Blog

DeepSeek API 申请与开发入门

最后更新：2026-09-09· 17 分钟阅读

🚀 快速通道

  • DeepSeek 国内版：点击直达↗
  • DeepSeek 镜像：打开镜像↗
  • 官方 DeepSeek：chat.deepseek.com ↗

DeepSeek API 申请与开发入门

更新时间：2026-08-12。

导读

「DeepSeek API」「DeepSeek API 申请」「DeepSeek Key」对应的是把模型接到网站、脚本、客服机器人或内部工具。可上线的接入不只是「请求 200」，还要管：密钥不进浏览器、超时与重试、结构化校验、用量与预算、日志脱敏。 端点、模型名、价格与限流以 官方 API 文档 为准；下文用占位符，避免写入易过期的具体型号与单价。

这篇解决什么问题？

  • 完成账号、计费与 API Key 准备
  • 用环境变量安全发起第一次请求
  • 设计超时、重试、错误分类与成本控制
  • 上线前过一遍安全清单，并知道如何接到 Codex

开通前准备：账户、Key、计费

  1. 从 DeepSeek 官网 进入官方开发/开放平台（入口文案以页面为准）。
  2. 完成账号登录与计费/充值开通；设置预算或用量告警（若控制台提供）。
  3. 创建 API Key：立即复制到密码管理器或密钥服务；页面可能不再完整显示。
  4. 给 Key 打用途标签（如 dev-chat / prod-summarizer），便于泄露后定向吊销。
  5. 在文档中确认当前 base URL、鉴权头、模型列表——不要从过期博客抄。

网页聊天账号与 API 的配额、模型、账单不要默认当成同一套。日常试用可走 DeepSeek V4 对话；产品集成必须走服务端 API。

环境变量：密钥只放服务端

# Linux / macOS 示例（本地开发）
export DEEPSEEK_API_KEY="your-secret-here"
# Windows PowerShell（仅当前会话；生产请用平台 Secret）
$env:DEEPSEEK_API_KEY = "your-secret-here"

硬性规则：

  • Key 永远不要写进前端、移动 App、公开仓库、截图、ISSUE
  • 用 process.env / 部署平台 Secret / 云厂商密钥管理器
  • 不同环境（dev / staging / prod）使用不同 Key
  • 怀疑泄露 → 控制台立刻吊销并轮换

第一个请求（占位符，请对照文档替换）

以下示例展示请求形状；请将 OFFICIAL_API_ENDPOINT 与 MODEL_NAME_FROM_DOCS 替换为 api-docs.deepseek.com 中的当前值。

import os
import requests

api_key = os.environ["DEEPSEEK_API_KEY"]
endpoint = "OFFICIAL_API_ENDPOINT"  # 从官方文档复制
model = "MODEL_NAME_FROM_DOCS"      # 从官方文档/控制台复制

resp = requests.post(
    endpoint,
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    json={
        "model": model,
        "messages": [
            {"role": "user", "content": "用三点解释什么是幂等性"}
        ],
    },
    timeout=60,
)
resp.raise_for_status()
print(resp.json())

跑通后立刻检查：响应里的用量字段（若有）、延迟、以及你是否误把 Key 打进了日志。

限时内测型号（如 V4.1 Flash）

官方偶发放出中间版本内测（例如 DeepSeek V4.1 Flash）：通常 base_url 不变，只改 model 为带过期日期的临时 ID；计费与并发以当日通知为准。此类 ID 禁止写死进生产配置，必须配回退到正式 Flash / Pro。专用步骤与评测清单见 V4.1 Flash 内测上手指南。

可复制业务提示（放在 messages 里）

你是内部知识助手。只根据提供的 context 回答。
若 context 不足，回答「资料中未提及」并列出缺失信息。
不得编造链接、法规条文或数据。
context:
"""
[脱敏段落]
"""
问题：[用户问题]

流式输出说明

交互式 UI 通常需要 streaming，让用户先看到部分 token。事件格式、SSE 字段与客户端解析方式以官方文档「流式」章节为准。注意：

  • 流式同样要设总体超时与空闲超时
  • 中途断开要可恢复或明确失败，避免前端无限转圈
  • 不要在浏览器持有 Key 去做「直连流式」；由后端代发

可靠性设计（上线必做）

  1. 超时：连接超时 + 读超时；避免请求挂死占满线程
  2. 重试：仅对 429 / 5xx / 网络闪断 做有限次指数退避；401/403/400 不要盲重试
  3. 幂等：写操作带业务幂等键，防止重试重复下单类副作用
  4. 校验：要求 JSON 时做 schema 校验；失败则安全降级或有限次「修复请求」
  5. 隔离：单用户 QPS 限额、全局限流、熔断
  6. 可观测：记录 request_id（若返回）、模型名、耗时、token、错误码；不记录原始身份证/银行卡/完整对话隐私
  7. 版本：system prompt、模型名、温度类参数纳入配置版本管理

错误处理对照表

情况典型表现处理
认证失败401 / 密钥无效检查环境变量与 Key 状态；不重试
权限/地区限制403查官方说明与账户状态
参数错误400 / 模型名无效对照文档修正 model 与字段
限流429退避、排队、降并发、申请提额
服务端错误5xx有上限重试 + 告警
超时client timeout缩短上下文、降 max tokens、异步化
输出不合格JSON 坏掉校验失败路径 + 有限次重试

成本控制

  • 限制输入长度与最大输出；长历史做摘要或截断
  • 对相同请求做缓存（注意个性化与隐私边界）
  • 按路由选模型：简单分类用轻量档，复杂推理再升档（名称以文档为准）
  • 记录每日 token 与费用；设置预算告警
  • 批处理尽量非高峰；避免无意义的多轮「再想想」循环

不要在教程或代码注释里写死「某模型每百万 token 价格」——以官方定价页实时数据为准。

安全清单（上线前必查）

  • Key 仅存在于服务端环境变量或密钥管理器
  • 仓库、CI 日志、前端 bundle 无密钥
  • 用户输入有长度限制与基础过滤（按合规要求）
  • 日志脱敏；保留期限明确
  • 定期轮换 Key；离职流程含吊销
  • dev / staging / prod Key 分离
  • 浏览器与 App 从不直持 Key

与 Codex / 编码代理

把 DeepSeek 接到编码代理时，同样遵守「密钥在本地/CI Secret、不进聊天记录截图」。逐步配置见：Codex DeepSeek 配置。

访问与入口

网页入口用于人工试用；API 用于服务端集成。两者模型列表与计费可能不同。

常见问题

API Key 可以放浏览器吗？

不可以。任何下发到浏览器的字符串都可能被用户取出。应由后端代为调用 DeepSeek。

模型名报错怎么办？

以控制台与 官方文档 的当前列表为准：可能已更名、未开通或拼写错误。用 MODEL_NAME_FROM_DOCS 占位提醒自己每次回查。

如何控制成本？

限制上下文与输出、缓存可复用结果、分档路由、设预算告警，并监控异常流量（被刷接口）。

是否需要保存完整对话？

只保存任务必需字段；设保留期限；对 PII 脱敏。合规要求高于便利性。

Key 泄露了怎么办？

立即在控制台吊销 → 创建新 Key → 排查 Git 历史、CI 日志、容器环境变量与前端产物 → 检查账单异常调用。

官方资源

下一步阅读

行动路径

今天：用环境变量跑通一条占位请求，打印用量与耗时。
明天：加上超时、429 退避与 schema 校验，删除代码里任何明文 Key。
本周：设预算告警，用 10 条真实输入做基准，再决定默认模型档位；需要代理则读完 Codex 配置。

相关内容