基本信息

项目	值
Base URL	`—`
鉴权方式	`Authorization: Bearer sk-xxxxx`
协议	OpenAI Chat Completions（也兼容 Anthropic / Gemini 格式）

密钥在控制台「令牌」页生成。一个账号可以有多个密钥，可以分别设置额度上限。

发一条请求

流式输出

curl — \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-v4.1-flash","stream":true,
       "messages":[{"role":"user","content":"写一段 Python 快排"}]}'

常用客户端配置

客户端	填什么
Cherry Studio / ChatBox	API 地址填 Base URL，类型选 OpenAI
Cursor	Settings → Models → Override OpenAI Base URL
Dify / FastGPT	模型供应商选 OpenAI-API-compatible
代码里	`base_url="—"`

错误码

状态码	含义	怎么处理
401	密钥无效或余额不足	检查密钥是否完整、是否带 `sk-` 前缀
404	路径不对	Base URL 要带 `/v1`
429	请求太频繁	按响应头 `Retry-After` 退避重试
500	上游异常	稍后重试；持续失败请联系客服

计费

按 token 计费，输入和输出分别计价，缓存命中的输入更便宜。具体单价见控制台「模型价格」页。

余额不足时会返回 401，请提前充值。