DeepSeek V4 Flash API

DeepSeek V4 Flash は、スループット重視の DeepSeek 製長文脈モデルです。ここでは /v1/chat/completions の OpenAI 互換エンドポイント 1 本として提供しています。1 リクエストで最大 256 メッセージ、合計 1,048,576 トークンまでを入力でき、最大 65,536 トークンを返します。推論の強さの既定は high です。

メッセージの内容はテキストのみです。tool_choice 付きで最大 128 個のツール、response_format による JSON 出力、SSE ストリーミングを同じ呼び出しで使えます。課金は入力・キャッシュ入力・出力に分かれます。

安いパスと丁寧なパスを同じ本文で

reasoning_effort の既定は high で、大量処理には low を使います。切り替えは同じ本文の文字列 1 つなので、1,000 件をざっと処理する 1 回目と、おかしかった 40 件を見直す 2 回目を同じ連携で回せます。

リポジトリを読んで所見を返す

枠は 1,048,576 トークン、1 回の返答は最大 65,536 トークンです。この比率が仕事の形を表しています。サービス全体を渡して求めるのはレビュー、優先度つきの所見リスト、狙いを絞ったパッチであって、送ったものすべての書き直しではありません。

求めれば JSON で返す

response_format を json_object にして system メッセージで項目名をすべて指定すれば、毎回同じ形で返ってきます。それでも、アプリケーション側では受け取った内容を解析・検証してから使ってください。

リポジトリ全体のレビュー

サービス、テスト、関係する仕様をまとめて送り、各所見にファイル名・行・影響する挙動を必ず書かせます。コードベース全体が文脈にあるので、当て推量ではなく 2 つ先のパッケージにある呼び出し元まで指し示せます。

契約書の束を JSON に

契約書の束を response_format を json_object にして送り、解析された条項をそのまま表に取り込みます。項目名は system メッセージで指定し、大量処理のパスでは推論を low にしておきます。

安く下書きし、難しい案件だけやり直す

キュー全体を low で処理し、チェックに通らなかった出力だけに印を付けて、同じメッセージ配列のまま high で送り直します。2 つの返答の違いは、推論の強さの項目だけになります。

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-flash/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 リファレンスを参照してください。