HopBase ドキュメントDeepSeek V4.1 / V4
HopBase の OpenAI 互換 Chat Completions API 経由で DeepSeek V4.1 Flash と V4 Pro / Flash を呼び出します。
DeepSeek V4.1 と V4 は HopBase の OpenAI 互換プロトコル上で動作します。https://api.hop-base.com/v1 を使用し、Authorization: Bearer sk-your-key を指定してください。正確なモデル ID は GET /v1/models から取得します。
モデル
| モデル ID | 備考 |
|---|---|
deepseek-v4.1-flash | V4.1 Flash。1M コンテキスト、最大 384,000 出力トークン。DeepSeek の公式リスト価格で提供され、思考内容は reasoning_content で返されます |
deepseek-v4-pro-202606 | V4 Pro。1,048,576 コンテキスト、最大 393,216 出力トークン |
deepseek-v4-flash-202605 | V4 Flash。1M コンテキスト、最大 384,000 出力トークン |
V4.1 Flash は専用のプラン「DeepSeek V4.1 Flash 官方直連」(DeepSeek V4.1 Flash 公式直結)に属しています。このプランに紐づくキーのみが V4.1 Flash に到達でき、V4 Pro / Flash 用のキーは到達しません。V4 Pro と V4 Flash は引き続き 1 つのプランを共有しており、そのプランのキーであればどちらにも到達できます。
短縮名は呼び出せません
正式なモデルは上表の ID のみです。deepseek-v4-flash、deepseek-v4-pro、そして DeepSeek 自身が V4.1 Flash に付けている短縮名 deepseek-flash は、いずれも同じ単純な 404 model_not_found を返し、汎用的な "The current group does not support the requested model" というメッセージが表示されます。レスポンスは代替の ID を示したり、日付付きの正式名を使うよう提案したりしません。これらの短縮名はどれもモデルに到達しないため、省略せず GET /v1/models から正確な ID を取得してください。
エンドポイント
POST /v1/chat/completions がサポートされているエントリポイントです。ストリーミングは正常に動作します。
ストリーミング時に usage が必要なら明示的に指定してください
クライアント側でストリーミングレスポンスからトークン使用量を読み取る必要がある場合は、stream_options: { "include_usage": true } を送信してください。指定しなくても課金は正確に行われますが、usage のチャンクがクライアントに届かなくなります。
DeepSeek の公式 API にある 2 つの機能は、こちらでは利用できません。Fill-in-the-Middle 補完とプレフィックス補完です。これらが使用するパスは HopBase ではルーティングされていません。
Claude Code はこれらのモデルを利用できません。Claude Code は Anthropic Messages プロトコルを話しますが、HopBase はこのプロトコルを DeepSeek ではなく GPT 系モデルにマッピングしています。
推論の出力
DeepSeek は思考の過程を content の中にではなく、独立した reasoning_content フィールドで返します。必要であれば明示的に読み取ってください。
completion_tokens にはすでに推論トークンが含まれているため、実際の出力長としてそのまま扱い、reasoning_tokens を重ねて加算しないでください。これは Grok とは異なる点です。Grok のチャットエンドポイントでは両者が別々に報告され、加算が必要です。
ゲートウェイがリクエストに加える変更
| 挙動 | リクエストへの影響 |
|---|---|
空の messages | リクエストが送信される前に 400 で拒否されます |
previous_response_id はここでは適用されません。HopBase 上の DeepSeek は Chat Completions のみに対応しており(Base URL とプロトコルを参照)、このプロトコルにはそのようなフィールドが存在しません。
プロンプトキャッシュ
プレフィックスキャッシュは暗黙的に行われます。切り替えるスイッチもなく、送信すべきキャッシュ制御パラメータもありません。ヒットは標準的な OpenAI のフィールドである usage.prompt_tokens_details.cached_tokens で報告されます。
HopBase の利用量レコードとレスポンスボディでは、入力のカウント方法が異なります。突き合わせる際は注意してください。
| フィールド | 意味 |
|---|---|
レスポンスの prompt_tokens | キャッシュ命中分を含むプロンプト全体 |
| 利用量レコードの入力トークン | プロンプトから、キャッシュ命中分を差し引いたもの |
| 利用量レコードのキャッシュ入力トークン | キャッシュ命中分を別立てで表示したもの |
つまり、利用量レコードの入力トークンとキャッシュ入力トークンを足すと、レスポンスの 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": "Summarize this quarter'\''s risks in five bullets." }]
}'レスポンスにおけるモデル識別子
レスポンスの model フィールドには、常にリクエストで指定した公開 ID がそのまま返されます。リクエストが別のルートで処理された場合でも HopBase はこの値を維持するため、response.model == request.model を検証するクライアントも問題なく動作します。
関連ページ
DeepSeek Harness では、dsh エージェントランタイム自体の接続方法(設定ファイルとカスタムプロバイダーのフォーム)を扱っています。このページは、その背後にあるモデル契約について説明しています。