はじめに
DeepSeek V4.1 Flash は、スループット重視の DeepSeek 製長文脈モデルです。ここでは /v1/chat/completions の OpenAI 互換エンドポイント 1 本として提供しています。最大 256 メッセージ、合計 1,048,576 トークンまでを読み、1 回の返答で最大 384,000 トークンを返せます。推論の強さの既定は high です。
メッセージにはテキストと画像を含められます。tool_choice 付きで最大 128 個のツール、response_format による JSON 出力、SSE ストリーミングを同じ呼び出しで使え、課金は入力・キャッシュ入力・出力に分かれます。
主な機能とハイライト
Flash モデルで長い出力
返答の上限は 384,000 トークン、枠は 1,048,576 トークンです。大量の文書からの全件抽出、長い翻訳、テストスイート一式も 1 つの返答で戻せるので、互いの出力を知らない複数の呼び出しをつなぎ合わせる必要がありません。
推論は出力の枠を分け合う
このモデルは答える前に推論し、その推論は max_tokens から差し引かれます。上限が小さすぎると思考だけで使い切ることがあります。120 トークンで計測したときは返答が空で戻り、そのリクエストは回答として課金されず、失敗扱いで返金されました。
同じ本文で 2 段階の推論
reasoning_effort の既定は high で、大量処理には軽い low を使います。切り替えは同じリクエストの文字列 1 つなので、一括処理と、その失敗分だけを丁寧にやり直す処理を 1 つの連携で回せます。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | 古い順に並べたターンで、最大 256 件。内容は文字列、または text と |
reasoning_effort | いいえ | none、low、high の 3 つで、既定は high です。none は推論パスを完全に省くため、推論トークンが請求に乗らない唯一の設定です(推論トークンは出力として課金されます)。 |
stop | いいえ | 最大 4 件の停止シーケンスを、文字列か配列で指定します。モデルがそのいずれかを書いた時点で応答が終わり、一致した文字列そのものは返されません。 1 文字以上 · 1 件以上 · 4 件以内 |
max_tokens | いいえ | 返答を 384,000 で抑えます。既定は 32,768 で、長い成果物は無音のまま打ち切られます。 |
tools | いいえ | 1 リクエストにつき最大 128 個の関数定義。 128 件以内 |
tool_choice | いいえ | auto / none / required、または呼ぶ関数を名指しするオブジェクト。 |
response_format | いいえ | 返答が人ではなくパーサーに渡るときは、JSON オブジェクトを要求してください。 |
料金
入力 $0.30 / 出力 $1.20 100 万トークンあたり
ユースケース
文書まるごとからの抽出
契約書一式や規程のアーカイブを、response_format を json_object にして丸ごと送り、義務や条項を 1 件ずつ構造化した行として求めます。出力に 384,000 トークンの余裕があるので、表全体がひとまとまりで返ってきます。
長いレポート付きのコードレビュー
ハンドラー、マイグレーション、テストを含むサービス全体を 1 リクエストに入れ、ファイルと行を添えて不具合を挙げさせます。事前に切り分けていないので、コントローラーとマイグレーションにまたがるバグも 1 回で見え、レポートにはすべての所見を書く余地があります。
関数を呼び出すエージェント
1 リクエストで最大 128 個のツールを宣言し、呼び出してよいかは tool_choice に任せます。結果は tool ロールのメッセージで戻り、assistant ターンの reasoning_content が前のステップの思考を引き継ぐので、計画を最初から立て直さずに済みます。
プロンプトガイドと実践のヒント
そのまま手直しして使える構造化呼び出し
POST https://api.spicyapi.ai/v1/chat/completions に {"model": "deepseek/v4.1-flash", "messages": [{"role": "system", "content": "Extract every obligation as JSON with keys party, duty, deadline and clause."}, {"role": "user", "content": "<the contract set>"}], "reasoning_effort": "low", "max_tokens": 60000, "response_format": {"type": "json_object"}} を送ります。長い出力では "stream": true を付けると、続きを書いている間にもトークンが届きます。このような抽出は low で十分に回ります。high に上げるのは、検証に通らなかったレコードだけにしてください。
数千トークンの余裕を残す
既定値の 32,768 では長い成果物が黙って途中で切れ、推論も同じ枠から消費されます。max_tokens は成果物の大きさに思考の余地を足して設定してください。上限は 384,000 です。
スキーマが受け付けないもの
ファイルのパートは料金計算の前に拒否され、reasoning_content は assistant メッセージでしか受け付けません。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.1-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 リファレンスを参照してください。







