Anthropic API 2026-10-21：temperature は 1.0 でも 400 に

API バージョン 2026-10-21 で Claude にリクエストを送ると、temperature、top_p、top_k のいずれかを指定しているだけで HTTP 400 が返る。デフォルト値でも例外ではなく、temperature: 1.0 は「temperature: Extra inputs are not permitted」で失敗する。これらは、モデルが次の token を選ぶ際のランダム性を調整するサンプリングパラメータだ。API バージョンはリクエストヘッダー anthropic-version で指定し、Messages API のリクエスト検証と応答の仕様を切り替える。旧バージョンは 2023-06-01。Anthropic が 10 月 21 日に同時リリースした SDK のメジャーバージョン（Python 2.0.0、TypeScript 1.0.0 ほか 5 種類）は、デフォルトで新バージョンを送信する。これらの SDK からはサンプリングパラメータ自体が削除されている。そのため、400 に遭遇するのは、HTTP クライアントから直接送る場合や追加の body フィールドを使う場合など、リクエスト body を自前で組み立てるコードだ。Claude Sonnet 4.6 と Claude Sonnet 5.5 で 8 種類のリクエストを両バージョンに送り、Python SDK の 2 つのバージョンを比較した。Synthorai 経由でも同じテストを行った。

TL;DR

• 2026-10-21 では、Claude Sonnet 4.6 と Sonnet 5.5 のどちらも temperature、top_p、top_k に 400 を返す。temperature: 1.0 も対象になる。
• 2026-10-21 は、assistant メッセージ内の document ブロックと、user のテキストブロックに付けた citations も拒否する。
• Anthropic の Python SDK 2.x は API キーを Authorization: Bearer で送る。両方のヘッダーがある場合、API は x-api-key を使う。
• Synthorai 経由では、どちらの SDK でも全 32 リクエストが 200 を返した。Anthropic API が 2026-10-21 で拒否する 12 リクエストも含む。

API バージョン 2026-10-21 で 400 になるリクエスト

400 の原因になる変更は 5 つある。3 つのサンプリングパラメータ、assistant メッセージへの document ブロックの直接配置、そして user メッセージのテキストブロックに付けた citations（テキストブロックから文書内の一節を参照する情報）だ。以下の表では、失敗する 6 ケースと引き続き成功する 2 ケースを検証した。各ケースをモデルとバージョンの組み合わせごとに 1 回ずつ、Anthropic API に直接送信した。200 は受理、400 は invalid_request_error による拒否を表す。

新バージョンでのエラーメッセージは以下のとおり。

Claude Sonnet 5.5 は 2023-06-01 の時点で、デフォルト以外のサンプリング値を拒否していた。ただし、メッセージは「`temperature` is deprecated for this model.」で、temperature: 1.0 は受理していた。2026-10-21 ではパラメータ自体がなくなったため、デフォルト値でも失敗する。Claude Sonnet 4.6 は旧バージョンではすべてのケースを受理した。Anthropic の移行ガイドによると、同じルールは token カウントと Message Batch 内の各リクエストにも適用される。Message Batch は、多数のリクエストを割引料金で非同期実行する Batch API だ。2023-06-01 の提供終了日は記載されていない。

各 400 エラーの修正方法

3 つのサンプリングパラメータを削除し、文書を user メッセージに移し、user として送るテキストから citations を取り除く。サンプリングパラメータを指定しないリクエストは、temperature の 1.0 を含むデフォルト値でサンプリングされる。これは 2023-06-01 でパラメータを省略した場合と同じ動作だ。Claude の過去の応答に付いた引用と、文書の "citations": {"enabled": true} は引き続き使える。

Python SDK で両バージョンに対応するリクエストは、次のようになる。

import anthropic

client = anthropic.Anthropic()  # 2.x sends anthropic-version: 2026-10-21

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    # no temperature, top_p or top_k: the parameters no longer exist in 2.x
    messages=[{"role": "user", "content": "Summarize this memo in one sentence."}],
)
print(message.content[0].text)

Claude Sonnet 4.6 のようにデフォルト以外の temperature をまだ受け付けるモデルで、その値が必要なリクエストは旧バージョンに残す必要がある。HTTP で直接送る場合は、ヘッダーを明示的に指定する。

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 256, "temperature": 0.2,
       "messages": [{"role": "user", "content": "Pick a number from 1 to 100."}]}'

Anthropic SDK の変更点

2026-10-21 を送るメジャーバージョンは、Python 2.0.0、TypeScript 1.0.0、Go 2.0.0、Java 3.0.0、C# 13.0.0、PHP 1.0.0、Ruby 2.0.0。API バージョンだけでなく、キーの送信方法と、クライアントが保持できる認証情報の数も変わった。ライセンスも MIT から Apache 2.0 に変更されている。Python SDK 1.17.0（最後の 1.x）と 2.3.0 をインストールし、受信した全リクエストのヘッダーと body を記録するローカルのエコーサーバーに接続した。

Python SDK のメッセージ用メソッドから temperature 引数が削除されたのは 1.0.0 だ。そのため Python でサーバー側の 400 に遭遇するのは、extra_body（リクエスト body にフィールドを直接追加する SDK オプション）を使う場合か、body を自前で組み立てる HTTP クライアントやライブラリを使う場合に限られる。Bearer ヘッダーは両方の API バージョンで使える。Authorization: Bearer <key> だけを付けたリクエストは 2023-06-01 でも 200 を返した。認証方式と API バージョンは別々に移行できる。

両方のヘッダーを送ると、どちらのキーが使われるか

両方のヘッダーがある場合、Anthropic API は x-api-key を使う。5 通りのヘッダーの組み合わせを両バージョンで試した。

Claude の手前にあるプロキシやゲートウェイと API とで、使用したキーの認識が食い違う可能性がある。SDK 2.x では、extra_headers={"X-Api-Key": other_key} で別のキーを追加するコードは、2 つのキーを送るようになる。Authorization にクライアントのキー、x-api-key にもう一方のキーが入る。Anthropic API は other_key で認証するが、Authorization しか読まないプロキシはクライアントのキーを使ったリクエストとして扱う。その結果、キー単位のクォータ、ログ、利用額上限が誤ったキーに紐づく。移行ガイドが示すクライアント側の修正は、別のキーを Authorization: Bearer <other_key> で送ることだ。プロキシ側では両方のヘッダーを読み、API と同じ優先順位（x-api-key が優先）を適用するか、異なるキーが指定されたリクエストを拒否する。

temperature を削除すると何が失われるか

temperature の削除による影響は、temperature: 0 に頼っていたチームが想定するほど大きくない。移行ガイドによると、Claude 4.7 以降はすでにデフォルト値しか受け付けないため、動作は変わらない。Claude Sonnet 4.6 のように別の値を受け付けるモデルでは、出力を安定させるために temperature を下げていたリクエストから、その効果が失われる。代わりになる設定はない。効果の大きさを測るため、2023-06-01 の Sonnet 4.6 に設定ごとに 20 リクエストを送った。すべてのリクエストが異なる内容になるよう、ランダムなリクエスト ID を末尾に追加した。

このような短い回答では、Sonnet 4.6 の出力はデフォルトの temperature でも 0 とほぼ同じ程度に集中した。temperature: 0 を削除しても変化は小さい。また、temperature: 0 も決定性を保証していたわけではない。20 回の試行で 2 種類の数字を返している。設定よりもプロンプトの文面のほうが出力に影響した。リクエスト ID を付けない場合は 42 が最多（temperature: 0 で 20 回中 17 回）だったが、付けると 47 が最多になった。再現性が必要なら、コードで回答を照合するかキャッシュする。サンプリングパラメータは、以前から再現性を保証するものではなかった。

Synthorai での API バージョン 2026-10-21 の扱い

Synthorai は両方の API バージョンと SDK からのリクエストを受け付ける。SDK 2.x に更新したり、anthropic-version: 2026-10-21 を送ったりしても、それまで動いていたリクエストは壊れない。両モデルの 16 ケースの検証を、2 つの anthropic-version の値で Synthorai 経由でも行った。全 32 リクエストが 200 を返し、Anthropic API が 2026-10-21 で拒否する 12 リクエストも成功した。Python SDK 1.17.0（x-api-key を送信）と 2.3.0（Authorization: Bearer を送信）は、どちらも base_url="https://synthorai.io" と同じキーで動作した。extra_body 経由の temperature も使えた。

Synthorai がこのように扱う理由は 4 つある。

• 同じモデルでも提供元は複数ある。Claude は Anthropic API、Amazon Bedrock、Google Cloud Vertex AI から利用でき、各提供元でバージョン文字列が異なる。Synthorai は各提供元が要求するバージョンを送るため、クライアントの anthropic-version ヘッダーがリクエストの検証方法を決めるわけではない。
• 移行中は新旧のクライアントが混在する。サービスごとに更新するため、同じアカウントから SDK 1.x の 2023-06-01 と SDK 2.x の 2026-10-21 が数週間にわたって送られる。両方を受け付ければ各サービスの都合に合わせて移行でき、どちらの SDK の認証ヘッダーでも同じキーを使える。
• コードを変えずにモデルを切り替えられる。Claude Sonnet 4.6 向けに temperature: 0.2 を設定したコードは、モデル名を、そのパラメータを受け付けない Claude Sonnet 5.5 に変えても動き続ける。切り替えだけでリクエストが失敗することはない。
• デフォルト値の指定で失敗させない。temperature: 1.0 は指定しなくてもモデルが使う値だ。拒否しても出力は変わらず、リクエストが失敗するだけになる。

ただし、200 が返っても、すべてのパラメータが効いたとは限らない。Sonnet 5.5 はデフォルトのサンプリング値しか受け付けないため、Synthorai 経由で temperature: 0.2 を送ると成功するが、ランダム性は下がらない。出力がサンプリング値に依存するなら、実際のプロンプトで指定の有無を比較してほしい。上の測定では、短い回答への影響は小さかった。

更新前の確認事項

FAQ

Claude へのリクエストが「temperature: Extra inputs are not permitted」で失敗するのはなぜか anthropic-version: 2026-10-21 で送信されているためだ。このバージョンには temperature パラメータがなく、1.0 を含め、どの値でも 400 になる。新しいメジャーバージョンの SDK は、このバージョンをデフォルトで送る。パラメータを削除するか、デフォルト以外の値をまだ受け付けるモデルでその値が必要なリクエストだけ、2023-06-01 に固定する。

anthropic-version 2023-06-01 は廃止されるのか Anthropic は 2023-06-01 の提供終了日を発表していない。移行ガイドにも、10 月 21 日の API リリースノートにも記載はない。ヘッダーを明示的に指定したリクエストは従来の動作を維持する。そのため、Claude Sonnet 4.6 の特定のリクエストで temperature を使い続けられる。

Anthropic API は引き続き x-api-key ヘッダーを受け付けるか Anthropic API は、両バージョンで x-api-key と Authorization: Bearer の両方を受け付ける。変更されたのは SDK が送るヘッダーだけだ。両方がある場合、API は x-api-key を使う。

関連記事

• Claude Sonnet 5.5 の料金：Sonnet 5 と比べたモデルの料金
• LLM の思考を制御する設定：新しい Claude モデルでも使える推論設定
• OpenCode の情報漏洩と API キーの保護：漏洩したキーによる被害を抑える方法
• LLM API のレート制限：キー単位の制限のカウント方法

← ブログに戻る