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 表單。本頁是它背後的模型契約。