创建并保存密钥
放进服务端配置或环境变量,不写进前端,也不提交到代码仓库。
查看密钥提示 →帮助中心 · 当天
这一页按任务分四组:复现、接入、排错、核验。每组一个标题加一段话,图片只作旁证。
DeepSeek - 探索未至之境:本页只记录可核对的参数、步骤与返回码,不作效果推断。
请求示例
下面是结构示意,字段名以平台文档当前写法为准。复制后先替换密钥与模型名。
消息按角色分条;温度低一点结果更稳,需要发散再调高。
POST /v1/chat/completions
Authorization: Bearer $KEY
{
"model": "模型名",
"messages": [
{"role":"user","content":"任务描述"}
],
"temperature": 0.2
}先取 choices 里的文本,再记 usage 的用量,便于对账和排查。
{
"choices":[{"message":{"content":"结果"}}],
"usage":{"total_tokens":128}
}报错排查
先看状态码,再查密钥、模型名、请求体,最后看频率限制。下表按出现频率排。
| 编号 | 状态码 | 常见原因 | 先检查 |
|---|---|---|---|
| E-01 | 401 | 密钥无效或过期 | 重新生成密钥,确认请求头格式 |
| E-02 | 404 | 模型名或路径不对 | 核对平台列出的模型名 |
| E-03 | 400 | 请求体字段缺失或超长 | 减少上下文,检查必填字段 |
| E-04 | 429 | 触发频率或并发限制 | 降速重试,加退避等待 |
| E-05 | 5xx | 服务端暂时异常 | 重试一次,保留请求 ID |
常见问题