DeepSeek シリーズ

DeepSeek の V4 シリーズのモデルで、V4.1 Flash、V4 Pro、V4 Flash があります。OpenAI 互換 API で呼び出せるほか、Anthropic ネイティブ API にも対応しており、Claude Code などのツールでそのまま使えます。

目的別ガイド

モデル

V4 シリーズのコンテキストは 1M トークン、最大出力は 384K トークンです。V4.1 Flash は画像入力に対応し、その他のモデルはテキストのみに対応しています。モデルの全一覧とリアルタイム価格はモデルページ を参照してください。

エイリアスとバージョン

• エイリアスは deepseek/ プレフィックスを付けずに使います（例："model": "deepseek-v4-pro"）。deepseek/deepseek-v4-pro と書くと 404 を返します。
• DeepSeek 公式 API の deepseek-chat と deepseek-reasoner は OfoxAI では使えません。上の表のモデル ID を使ってください。
• 旧バージョンの deepseek/deepseek-v4-pro-0423 と deepseek/deepseek-v4-flash-0423 も引き続き呼び出せますが、思考の有効化の方法が新バージョンと異なります。思考モードを参照してください。

呼び出し例

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "冪等性とは何かを一文で説明してください。"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(resp.choices[0].message.content)

curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "messages": [{"role": "user", "content": "冪等性とは何かを一文で説明してください。"}],
    "thinking": {"type": "disabled"}
  }'

思考モード

実測では、同じ数学の問題で V4 Pro はデフォルトで約 1.2 万トークン思考し、約 2 分かかりました。思考を無効にすると約 20 秒でした。思考トークンは出力単価で課金され、トークン数は usage.completion_tokens_details.reasoning_tokens で確認できます。

思考内容の読み取り

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "17 × 23 はいくつですか？"}],
)
msg = resp.choices[0].message
details = getattr(msg, "reasoning_details", None) or []
print("[思考]", "".join(d.get("text", "") for d in details))
print("[回答]", msg.content)

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
stream = client.chat.completions.create(
    model="deepseek/deepseek-v4-flash-0731",
    messages=[{"role": "user", "content": "17 × 23 はいくつですか？"}],
    stream=True,
)
for chunk in stream:
    if not chunk.choices:
        continue
    delta = chunk.choices[0].delta
    thinking = getattr(delta, "reasoning_content", None)
    if thinking:
        print(thinking, end="", flush=True)
    if delta.content:
        print(delta.content, end="", flush=True)

• 非ストリーミングのレスポンスでは、思考内容は message.reasoning_details にあります。各要素の text を順に連結してください。
• ストリーミングのレスポンスでは、思考内容は delta.reasoning_content にあり、DeepSeek 公式 API と同じです。
• 複数ターンの会話では、履歴メッセージに思考内容を含めて送り返す必要はありません。

Claude Code で使う

DeepSeek V4 シリーズは Anthropic ネイティブ API に対応しています。URL は https://api.ofox.io/anthropic で、Claude Code など Anthropic プロトコルに基づくツールで使えます。

curl https://api.ofox.io/anthropic/v1/messages \
  -H "x-api-key: $OFOX_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4-flash-0731",
    "max_tokens": 4000,
    "thinking": {"type": "disabled"},
    "messages": [{"role": "user", "content": "冪等性とは何かを一文で説明してください。"}]
  }'

• Anthropic API で呼び出す場合、思考内容は thinking ブロックとして返されます。"thinking": {"type": "disabled"} で同様に思考を無効にできます。
• 思考を有効にする場合は、max_tokens を十分に大きく設定してください。上限が足りないと、レスポンスに thinking ブロックだけが含まれ、回答がないことがあります。

Claude Code の設定手順の詳細は Claude Code の設定を参照してください。

JSON 出力とツール呼び出し

response_format は {"type": "json_object"} と {"type": "json_schema", ...} に対応しています。ツール呼び出しには標準の tools パラメーターを使います。

import json
import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="deepseek/deepseek-v4-pro-0813",
    response_format={"type": "json_object"},
    messages=[{"role": "user", "content": "price と currency を JSON で返してください：バットとボールは合わせて 1.10 ドルで、バットはボールより 1 ドル高い。ボールはいくら？"}],
    extra_body={"thinking": {"type": "disabled"}},
)
print(json.loads(resp.choices[0].message.content))

json_object を使う場合は、プロンプトに「JSON で返す」ことと必要なフィールドを明記してください。

プロンプトキャッシュ

DeepSeek は重複するリクエストのプレフィックスを自動でキャッシュするため、リクエストを変更する必要はありません。ヒット量は usage.prompt_tokens_details.cached_tokens で確認でき、ヒットした部分はキャッシュ読み取り単価で課金されます。キャッシュはベストエフォートで、プレフィックスが同じリクエストでもヒットしない場合があります。

プロバイダー

プロバイダーの指定方法はプロバイダールーティングを参照してください。

よくあるエラー

その他の共通エラーは Error Handling を参照してください。

公式ドキュメント

• DeepSeek API ドキュメント 
• DeepSeek · 思考モード 
• DeepSeek · Anthropic API 互換 

公式ドキュメントは DeepSeek に直接リクエストした場合の動作を説明しています。OfoxAI 経由で呼び出す場合、モデル ID とエンドポイントの URL はこのページに従ってください。

よくある質問