HopBase 文档DeepSeek V4
通过 HopBase 的 OpenAI 兼容 Chat Completions 接口调用 DeepSeek V4 Pro 与 Flash。
DeepSeek V4 走 HopBase 的 OpenAI 兼容协议。使用 https://api.hop-base.com/v1,鉴权头为 Authorization: Bearer sk-your-key,模型 ID 以 GET /v1/models 返回的精确写法为准。
模型
| 模型 ID | 说明 |
|---|---|
deepseek-v4-pro-202606 | V4 Pro |
deepseek-v4-flash-202605 | V4 Flash,1M 上下文,单次最多 384,000 输出 Token |
两个同属一个套餐分组,一把密钥都能调。
裸名调不通
只有上面带日期后缀的 ID 是正式模型。deepseek-v4-flash 会被 400 拒绝,并在报错里点名应改用 deepseek-v4-flash-202605;deepseek-v4-pro 返回 404 model_not_found。两个裸名都到不了模型,请从 GET /v1/models 读取完整 ID,不要自己缩写。
端点
POST /v1/chat/completions 是支持的入口,流式正常可用。
流式要拿 usage 得显式订阅
客户端需要从流式响应里读 Token 用量时,请传 stream_options: { "include_usage": true }。不传也不影响计费准确性,只是那个 usage 块不会下发给客户端。
DeepSeek 官方接口上的两项能力在这里不可用:中间填充(FIM)补全与前缀续写。它们所在的路径 HopBase 不做转发。
Claude Code 用不了这两个模型。它走 Anthropic Messages 协议,HopBase 会把该协议映射到 GPT 系模型,而不是 DeepSeek。
推理输出
DeepSeek 把思考过程放在独立的 reasoning_content 字段里,不在 content 中。需要的话请单独读取。
completion_tokens 已经包含推理 Token,把它当作真实输出长度即可,不要再加 reasoning_tokens。这一点与 Grok 不同——Grok 的 chat 端点是分开报的,必须相加。
网关会改动请求的地方
| 行为 | 对请求的影响 |
|---|---|
| 消息历史守卫 | 消息超过 26 条时只保留开头最多 2 条 system / developer 消息,加上最后 24 条,中间的会被丢弃 |
previous_response_id | 存在则剔除。请求会在多个账号间负载均衡,某个账号签发的 ID 在另一个账号上无效 |
空 messages | 在打上游之前就以 400 拒绝 |
历史守卫对 1M 上下文模型同样生效
长多轮会话是按消息条数截断的,不是按 Token 数。如果你的 Agent 依赖完整历史,请自己把历史压缩进更少的消息里,并把必须保留的内容放在前两条 system 消息中。
前缀缓存
前缀缓存是隐式的——没有开关,也不需要传任何缓存控制参数。命中情况体现在标准 OpenAI 字段 usage.prompt_tokens_details.cached_tokens 里。
HopBase 的用量记录与响应体对输入的口径不同,对账时要注意:
| 字段 | 含义 |
|---|---|
响应体 prompt_tokens | 整个 prompt,含缓存命中部分 |
| 用量记录输入 Token | prompt 减去缓存命中部分 |
| 用量记录缓存输入 Token | 缓存命中的那部分,单列 |
也就是说,用量记录里的输入加缓存输入,等于响应体的 prompt_tokens。缓存读与普通输入分开计价,适用于你这把密钥的单价见登录后的模型广场。
curl
curl https://api.hop-base.com/v1/chat/completions \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4-pro-202606",
"messages": [{ "role": "user", "content": "用五条要点总结本季度的风险。" }]
}'响应里的模型标识
响应体里的 model 字段始终回显你请求的公开 ID。即使请求被换到另一条上游路由,这个值也保持不变,所以做 response.model == request.model 断言的客户端不会被打断。
相关文档
DeepSeek Harness 讲的是 dsh 这个 Agent 运行时本身怎么接——配置文件与自定义 provider 表单。本页是它背后的模型契约。