はじめに
DeepSeek V4 Pro は DeepSeek V4 の 2 モデルのうち、じっくり考える側のモデルです。ここでは /v1/chat/completions の OpenAI 互換エンドポイント 1 本として提供しています。最大 1,048,576 トークンを読み、既定で推論の強さ high のまま考え、1 回の返答で最大 384,000 トークンを書けます。
low は素早い下書き用です。メッセージの内容はテキストのみで、1 リクエストあたり最大 256 メッセージです。最大 128 個のツール、response_format による JSON 出力、SSE ストリーミングを使え、入力・キャッシュ入力・出力は別々に計量されます。
主な機能とハイライト
出発点は high
追加の推論が見合うのはレビュー、マイグレーション、セキュリティの仕事です。そのためこのエンドポイントは high から始まり、low は下書きに回します。推論は出力トークンとして消費されるので、別料金ではなく同じ請求に載り、指定した max_tokens にも同じように数えられます。
仕様・コード・テストを 1 リクエストに
1,048,576 トークンあれば、設計書、実装、テストスイートをまとめて送れます。モデルはあなたの要約を信じるのではなく、それらを突き合わせます。不変条件は system メッセージに、資料はその下に古い順で置けば、どの食い違いもモデルが引用できる箇所に結び付きます。
答えを丸ごと書ける余裕
1 回の返答は最大 384,000 トークンです。順序立てた計画、各ステップの SQL、その検証クエリまでが 1 つの返答に収まります。既定値の 32,768 ではエラーなしで途中で切れるため、max_tokens は成果物に合わせて設定してください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | 順序付きのターンを最大 256 件、内容はテキストのみです。ツールを挟んだ会話の一貫性を保つには、assistant ターンの |
reasoning_effort | いいえ | none、low、high の 3 つで、既定は high です。none は推論パスを完全に省くため、推論トークンが請求に乗らない唯一の設定です(推論トークンは出力として課金されます)。 |
stop | いいえ | 最大 4 件の停止シーケンスを、文字列か配列で指定します。モデルがそのいずれかを書いた時点で応答が終わり、一致した文字列そのものは返されません。 1 文字以上 · 1 件以上 · 4 件以内 |
max_tokens | いいえ | 返答を 384,000 で抑えます。既定の 32,768 は、移行計画をエラーなしで打ち切ります。 |
tools | いいえ | 1 リクエストにつき最大 128 個の関数定義。 128 件以内 |
parallel_tool_calls | いいえ | true か false で、既定値は true です。true ではモデルが 1 ターンで複数のツール呼び出しを要求できます。 デフォルト値: |
tool_choice | いいえ | auto / none / required、または呼ぶ関数を名指しするオブジェクト。 |
response_format | いいえ | 答えをコードが処理するときは JSON オブジェクトを要求してください。 |
料金
入力 $1.32 / 出力 $3.96 100 万トークンあたり
ユースケース
仕様と実装の突き合わせ監査
設計書と、それを実装したとされるコードを 1 リクエストで送り、食い違いをすべて影響範囲の大きい順に挙げさせます。どちらも要約する必要がないので、欠けている不変条件は記憶ではなく比較によって見つかります。
high でのセキュリティ確認
認証の経路や資金移動のフローに high を向け、書き方の指摘ではなく悪用できる手順を求めます。推論を増やすコストは出力トークンですが、権限昇格の経路を見逃すコストはその比ではありません。
スキーマ全体のマイグレーション計画
すべてのマイグレーションファイルと現在のテーブル定義を渡し、各ステップのロールバック付きで順序立てた計画を求めます。計画、SQL、検証クエリがまとめて 1 つの返答で戻ってきます。
プロンプトガイドと実践のヒント
受け入れ基準を system メッセージに書く
曖昧な依頼では high の推論が無駄になります。資料を貼る前に、正しい答えに何が含まれるべきか、たとえばファイル参照付きの食い違い、優先度順のリスト、ステップごとのロールバックを明記し、モデルが何かに照らして確認できるようにします。
仕事に見合った推論の強さで 1 回呼ぶ
POST https://api.spicyapi.ai/v1/chat/completions に {"model": "deepseek/v4-pro", "messages": [{"role": "system", "content": "Compare the specification against the implementation. List every divergence with file references, then rank by blast radius."}, {"role": "user", "content": "<spec>\n\n<implementation>"}], "reasoning_effort": "high", "max_tokens": 32000} を送ります。行動する前に、最上位の所見は自分で確かめてください。high はより丁寧ですが、誤りがないわけではありません。
失敗するリクエストの形
image_url とファイルのパートはスキーマで拒否されるため、マルチモーダルモデルからコピーした本文は料金計算の前に失敗します。384,000 を超える max_tokens は無効で、1,048,576 トークンの枠には system プロンプトと過去のすべてのツール結果が含まれます。
API クイックスタート
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "deepseek/v4-pro/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。







