仕様の整理・2026年11月8日に確認
temperature・top_p・top_k が使えなくなった経緯
生成のばらつきを調整する3つの指定は、2026年のうちに段階的に消えました。モデルの追加ごとに少しずつ厳しくなったため、「いつから」が分かりにくい項目です。
このサイトはAnthropicの公式サイトではありません。モデルの提供状況・仕様・料金は変わる可能性があるため、実装や契約の前には公式のドキュメントとご自身のアカウント設定を確認してください。
先に結論
最初に400になったのは Opus 4.8（2026年5月28日）で、既定値以外の temperature・top_p・top_k が対象でした。Sonnet 5（6月30日）も同様です。さらに API バージョン 2026-10-21（10月21日）では、この3つはどんな値でも400になります。公式の廃止の一覧は、この3つを「API バージョン 2026-10-21 で除去」と書き、代わりにプロンプトで振る舞いを導くよう案内しています。
時系列
| 日付 | 出来事 |
|---|---|
| 2026年5月28日 | Opus 4.8：既定値以外を送ると400 |
| 2026年6月30日 | Sonnet 5：既定値以外は400（公開時のリリースノート） |
| 2026年8月20日 | Python SDK v1.0：Messages のメソッドから temperature・top_p・top_k の引数が消える |
| 2026年10月7日 | Haiku 5.5：Haiku 4.5 と違い、サンプリング指定は400 |
| 2026年10月21日 | API バージョン 2026-10-21：3つの指定はどの値でも400 |
廃止の一覧は、古い API バージョンでは Claude 4.7 以降のモデルと Mythos Preview に限って、非既定値が400になると整理しています。
代わりに何をするか
- 出力の安定が要る：指示で形式・長さ・観点を固定し、構造化出力を使う
- 多様な案が要る：1回の依頼に「5案を観点を変えて」と書く。値で振らない
- 再現性が要る：同じ入力でも出力が変わりうる前提で、検査側を作る
点検の手順
- 送信コードとラッパー（社内の共通関数）で、3つの名前を検索する
- 外す前に、その値がなぜ入っていたかを書き出す（コピーされた既定のこともある）
- 外したあと、出力の分布が変わるかを同じ入力で数回試す
- SDK を v1 以降に上げると、引数そのものがなくなる。型エラーで見つかる
具体例：温度を下げて安定させていた処理の移し方
以前 temperature を0.2にして、出力の揺れを抑えていた処理があるとします。外したあとは、揺れ方が変わります。そこで、(1) 出力の形式を固定する指示を書く、(2) 構造化出力で形を縛る、(3) 同じ入力を5回通して出力の違いを測る、の順で調べます。違いが許容範囲なら、そのまま外します。許容できないなら、判定の部分をコード側に移し、モデルには候補だけを出させる設計にします。値で揺れを調整する手段がなくなったので、揺れを前提にした検査が要る、というのがこの変更の実務上の意味です。
よくある取り違え
- 「既定値と同じなら安全」と読む：API バージョン 2026-10-21 では、値に関係なく400
- 「SDK を上げただけで直る」と読む：SDK v1.0 は引数ごと消すので、型エラーで見つけて直す必要がある
- 「温度を下げる以外に手がない」と読む：公式の案内はプロンプトで振る舞いを導くこと
自分の環境で確かめるには
API バージョンを指定する設定（anthropic-version ヘッダー）が、どの値になっているかをまず確認します。2026-10-21 以降なら、3つの指定はどの値でも400です。それより古い版なら、モデルによって既定値だけ通ります。どちらの環境で動いているかを知らずに外し忘れを探すと、本番と試験で結果が食い違います。
この面で確かめていないこと
- Sonnet 4.6 以前でこの3つがどこまで使えるか（旧世代のため確かめていない）
- 外したときの出力のばらつきの実測
よくある質問
既定値と同じ値なら送ってよいですか？
API バージョン 2026-10-21 では、値に関係なく400です。古い版では既定値なら通るモデルがあります。
SDK を上げたら引数が消えました。
2026年8月20日の Python SDK v1.0 での変更です。
何で代わりに制御しますか？
公式の案内はプロンプトです。構造化出力や effort との組み合わせで調整します。
出典（2026年11月8日に確認）
- モデルの廃止の一覧（Anthropic の API ドキュメント） https://platform.claude.com/docs/en/about-claude/model-deprecations
- Claude Platform のリリースノート（Anthropic） https://platform.claude.com/docs/en/release-notes/overview
編集：ちんあなご編集部。記事の文は写さず、日付・数字・名前などの事実だけを自分の文で書いています。