DeepSeek API支持OpenAI兼容接口接入，但必须严格使用Bearer Token认证（Authorization: Bearer sk-...）、base_url为https://api.deepseek.com、模型名仅限deepseek-chat或deepseek-reasoner小写无后缀，且需完成实名认证与余额充值，否则返回401/403/404等错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
DeepSeek API 能直接用 OpenAI 兼容接口接入，不需要改业务逻辑，但必须用对认证方式、URL 和模型名——错一个就 401 Unauthorized 或 404 Not Found。
Authorization 头写错是最常见的 401 原因
DeepSeek 只接受 Bearer Token 认证，不支持 OAuth2、HMAC 签名或 api_key 参数传参。很多开发者看到文档里提过 OAuth2 就误以为要走 token 流程，其实那是企业级私有部署才用的路径。
-
Authorization头必须是Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx，不能漏掉Bearer前缀，也不能多加空格 - 密钥必须从
platform.deepseek.com的 API Keys 页面创建，不是控制台其他地方的「应用密钥」或「secret_key」 - 密钥只显示一次，粘贴时注意有没有复制到换行符或中文引号（常见于微信/钉钉转发）
- 若用环境变量注入，检查
os.getenv("DEEPSEEK_API_KEY")是否返回非空字符串，建议加一行print(repr(os.getenv("DEEPSEEK_API_KEY")))确认
base_url 和 endpoint 必须匹配官方域名
OpenAI SDK 默认发请求到 https://api.openai.com，不改 base_url 就算密钥和参数全对，也会收到 {"error": {"message": "Not Found", ...}}。
- Node.js 中必须显式传
baseURL: "https://api.deepseek.com"，不能只写base_url或漏掉https:// - Python 的
openai库（v1.0+）同样需要base_url参数，不是api_base；旧版openai==0.28不兼容，会报AttributeError: module 'openai' has no attribute 'chat' - cURL 示例里的 URL 是
https://api.deepseek.com/chat/completions，不是/v1/chat/completions或/v1/text-generation—— 后两者是旧版或私有部署路径，公有云 API 不响应
model 参数填错会导致 404 或 422
DeepSeek 公有云只开放有限几个模型，deepseek-chat 和 deepseek-reasoner 是唯二稳定可用的，其他如 deepseek-v3 deepseek-r1 等名称目前不被 API 接受。
- 请求体中
"model": "deepseek-chat"必须完全小写、无空格、无版本后缀（例如不要写成"deepseek-chat-v3"） - 如果选了
deepseek-reasoner却没充值够余额，会返回429 Too Many Requests（不是配额超限提示，而是直接拒绝） - 流式响应（
"stream": true）可用，但需确保客户端能处理 SSE 格式；Node.js 的openaiSDK 默认支持，Python 需手动迭代response对象
实名认证和余额是调用前的硬性门槛
即使代码完全正确，未完成实名认证或余额为 0，API 仍会返回 403 Forbidden，且错误信息不提示具体原因——这是最容易卡住新手的黑盒环节。
- 个人账号必须上传身份证正反面，企业账号必须提交营业执照，审核通常 1–3 个工作日，不能跳过
- 新用户赠送的免费额度仅限首次调用，用完即停；测试阶段建议先充 ¥10，避免反复等待审核
- OpenClaw 等 GUI 工具测试成功 ≠ API 可用：它可能缓存了旧 token 或绕过了余额校验，务必用 curl 或 SDK 直接调用验证
真正难的不是写几行代码，而是确认平台侧状态是否就绪——实名、余额、密钥生成、密钥粘贴这四步，任意一步出错，下游所有请求都会静默失败。别在代码里反复调试，先去 platform.deepseek.com 页面右上角点用户名，看「实名认证」和「余额」两个标签是否都显示绿色对勾。
