DeepSeek API 接入：密钥申请与调用说明

DeepSeek 开放平台向开发者提供与客户端同源的模型能力，支持按 token 计费的弹性调用。下面按顺序说明从注册到发出首个请求的关键环节。

注册与实名认证

访问 DeepSeek 开放平台，使用邮箱或手机号完成注册。企业用户需补充主体信息以开通发票与更高配额；个人开发者完成基础认证即可创建 API Key。

控制台中会展示各模型的价格与上下文长度限制，部署前应确认所选模型是否满足业务延迟与成本要求。

创建与管理 API Key

1. 进入控制台「API Keys」页面，点击创建新密钥。
2. 为密钥添加备注，如「客服机器人-测试环境」，便于日后审计。
3. 完整密钥仅在创建时显示一次，请立即保存到密钥管理系统，勿写入公开仓库。
4. 若密钥泄露或人员离职，应马上吊销并轮换新 Key，检查近期调用日志是否异常。

基础调用方式

DeepSeek API 兼容常见的 Chat Completions 风格接口。请求头需携带 Authorization: Bearer YOUR_API_KEY，正文指定模型名称、消息数组及可选参数（temperature、max_tokens 等）。

首次集成建议先用短 prompt 验证连通性，再逐步放开 max_tokens 做长文测试。流式输出（stream: true）适合对话界面，可降低首字等待时间。

模型选择参考

• deepseek-chat（V3） — 通用对话、文案与摘要，性价比均衡。
• deepseek-reasoner（R1） — 复杂推理与分步分析，单请求耗时较长。
• Coder 系列 — 代码补全、审查与生成，适合 IDE 插件与 CI 集成。

同一应用可根据路由规则分流：简单 FAQ 走 V3，工单研判走 R1，以平衡成本与效果。

用量监控与错误处理

控制台提供按日、按模型的 token 统计，建议设置预算提醒。常见错误包括 401（密钥无效）、429（速率限制）和 500（服务端异常）。客户端应实现指数退避重试，并对 4xx 错误记录请求摘要以便排查。

上线前在预发环境压测峰值 QPS，确认账户配额足够；活动大促期间可提前联系商务调整限额。

安全与合规建议

勿将用户隐私原文无过滤地传入模型；必要时先做脱敏。日志中记录 request_id 而非完整对话内容，既方便追踪又降低泄露风险。涉及医疗、金融等强监管领域时，应增加人工审核环节，API 输出仅作辅助参考。