45 lines
2.0 KiB
Markdown
45 lines
2.0 KiB
Markdown
# Anthropic Messages API: `max_tokens` パラメータ仕様
|
||
|
||
Source: https://platform.claude.com/docs/en/api/messages
|
||
Retrieved: 2026-04-28
|
||
|
||
---
|
||
|
||
## 1. パラメータ名
|
||
|
||
`max_tokens`
|
||
|
||
`max_output_tokens` ではない。
|
||
|
||
## 2. 必須か任意か
|
||
|
||
**必須 (required)**。
|
||
|
||
`POST /v1/messages` のボディパラメータとして必須指定。
|
||
yoi の現在の実装（`max_tokens: u32`、未指定時 4096 にフォールバック）は仕様と合致している。
|
||
|
||
## 3. 型・範囲
|
||
|
||
- 型: integer (number)
|
||
- 意味: 生成を停止する前に出力できるトークンの上限。モデルはこの値に達する前に停止することもある（上限の指定であり、保証値ではない）
|
||
- モデルごとに最大値が異なる:
|
||
- Claude Opus 4.6 / 4.7: 最大 128k トークン
|
||
- Claude Sonnet 4.6 / Haiku 4.5: 最大 64k トークン
|
||
- Message Batches API + beta ヘッダ `output-300k-2026-03-24`: 最大 300k トークン（Opus 4.7, 4.6, Sonnet 4.6）
|
||
|
||
## 4. Extended Thinking との組み合わせ制約
|
||
|
||
Source: https://platform.claude.com/docs/en/build-with-claude/extended-thinking
|
||
|
||
- `thinking.budget_tokens` は必ず `max_tokens` **未満** でなければならない
|
||
- thinking トークンは `max_tokens` の上限に含まれてカウントされる
|
||
- `budget_tokens` の最小値は **1,024 トークン**
|
||
- 例外: ツールを伴う interleaved thinking では `budget_tokens` が `max_tokens` を超えることが許容される（予算がコンテキストウィンドウ全体に対して適用されるため）
|
||
- `max_tokens` が 21,333 を超える場合はストリーミングが必須
|
||
- Claude Opus 4.6 / Sonnet 4.6 以降では `budget_tokens` は非推奨になり、代わりに `effort` パラメータによる adaptive thinking が推奨されている
|
||
|
||
## 5. ドキュメント URL
|
||
|
||
- Messages API リファレンス: https://platform.claude.com/docs/en/api/messages
|
||
- Extended Thinking ガイド: https://platform.claude.com/docs/en/build-with-claude/extended-thinking
|