モデルの呼び出し

max_tokens とは？設定しないとどうなりますか？

max_tokens、max_completion_tokens、max_output_tokens と、モデル呼び出しの出力 Token 上限を設定する方法を説明します。

短い答え

max_tokens は、モデルが 1 回のレスポンスで生成できる Token 数を制限します。API とモデルによって、項目名、必須設定、デフォルト動作が異なります。

安定した出力のために、長い回答、コード生成、ドキュメントタスクでは明示的な出力上限を設定します。Claude / Anthropic 互換 API 呼び出しでは、通常 max_tokens を明示的に送信する必要があります。

概念	意味
Input Token	メッセージ、コンテキスト、ファイル内容、ツール結果、その他の入力
Output Token	モデルが生成する表示可能なレスポンス
Reasoning Token	一部の推論モデルが内部で使用する非表示の推論 Token
コンテキストウィンドウ	入力、出力、一部の内部 Token が共有する上限
出力上限	1 回のレスポンスで生成する表示可能な出力の最大値

出力上限が小さすぎると、レスポンスが途中で切れる場合があります。非常に大きくしても、モデルが必ずその数の Token を生成するわけではありませんが、長い出力のタスクではコストが増える場合があります。

パラメーター	一般的な用途
`max_tokens`	Claude / Anthropic Messages API と、一部の Chat Completions 設定
`max_completion_tokens`	Chat Completions 経由の一部 OpenAI 推論モデル
`max_output_tokens`	OpenAI Responses API で一般的な出力上限項目

Codex CLI または Responses API ベースの別のツールを使用する場合は、そのツールまたはプロバイダーが現在サポートする項目に従ってください。すべてのモデルに同じパラメーター名を固定しないでください。

動作はプロバイダーと API によって異なります。

シナリオ	起こりうる結果
Claude / Anthropic 互換 API	明示的な `max_tokens` 値が必要になる場合がある
OpenAI 互換 Chat Completions	モデルのデフォルト動作を使用する場合がある
OpenAI Responses API	`max_output_tokens` またはツールのデフォルトを使用する場合がある
その他のモデル	独自のデフォルト出力上限がある場合がある

同じコードでも、モデルを切り替えると出力の長さが変わる場合があります。本番での想定外を減らすため、明示的な出力上限を設定してください。

タスク	推奨範囲
一般的な Q&A	`1024` - `4096`
コード解説 / 小さな編集	`4096` - `8192`
長文作成 / 複雑なコーディングタスク	モデル上限に応じて `8192` 以上
バッチタスク	想定外に長いレスポンスを避けるため、小さい上限を使用する