DeepSeek API 完整接入教程：从注册到生产环境的实战指南

注册与获取密钥

登录 ChinaWHAPI 控制台，在 API Keys 页面生成新密钥。建议为开发、测试、生产环境分别创建不同密钥，方便管理权限和用量。

调用 DeepSeek R1 推理模型

DeepSeek R1 是推理模型，适合需要复杂思考和多步骤推理的场景。使用时注意它的输出会包含完整的思考链（Chain of Thought）。

curl https://chinawhapi.com/v1/chat/completions \
  -H "Authorization: Bearer {key}" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-r1","messages":[{"role":"user","content":"用数学归纳法证明 1+2+...+n = n(n+1)/2"}]}'

调用 DeepSeek V3 通用模型

V3 是快速通用模型，适合日常对话、内容生成、代码辅助等非推理场景，响应更快、成本更低。

curl https://chinawhapi.com/v1/chat/completions \
  -H "Authorization: Bearer {key}" \
  -d '{"model":"deepseek-v4-flash","messages":[{"role":"user","content":"写一个 Python 快速排序"}]}'

错误处理

401 表示密钥无效；429 表示触发了速率限制（建议加指数退避重试）；500 通常是上游临时异常，稍等重试即可。

生产环境建议

在生产环境中建议实现：重试机制（带退避）、密钥轮换（避免单点失效）、用量监控（避免意外超支）和模型降级策略（主力模型不可用时自动切备选）。