Claude API の temperature が消えた？

Transcript

1. AIニュース（2026年11月） Claude API の temperature が消えた？ 2026-10-21 版で変わること（API の版と、SDK・CLI のメジャー版） 赤神 青空
2. ▪2026年10月21日、Claude 何が出たかAPI の新しい版 2026-10-21 10⽉21⽇：Claude API の新しい版「2026-10-21」 これまでの版は 2023-06-01。版はリクエストの anthropic-version ヘッダーで選ぶ temperature などを送ると 400 Admin API の名前が変わる 同じ⽇に、SDK と CLI もメジャー版が出た 新しい SDK と CLI は、何も指定しなくても 2026-10-21 を送る API の版とは別に、SDK の側で変わる所もある （キーの送り⽅‧型‧Text Completions‧ライセンス） 今ココ 概要 2/16
3. ▪SDK を上げると、送る版も上がる 版はどう決まるか SDK を使わないとき curl .../v1/messages \ -H "anthropic-version: 2026-10-21" \ ... ヘッダーの値が、そのまま リクエストの版になる 2023-06-01 を送れば、 これまでの版のまま 今ココ 概要 SDK を使うとき メジャー版が出た時点の、最新の版を送る Python .. TypeScript .. C# .. Go .. Java .. PHP .. Ruby .. CLI（ant） .. この版から 2026-10-21。前の版は 2023-06-01 を送る 3/16
4. ▪既定値でもエラー。送らなければ温度 temperature などを送ると 400 1.0 で動く { } "max_tokens": 1024, "temperature": 1.0, "messages": [ ... ] 400 エラー （既定値の 1.0 でも） top_p‧top_k も同じ。3つのどれかを送ると 400 送らなければ、temperature . を含む既定値で動く 2023-06-01 で、この3つを省いたときと同じ Messages API と Message Batches のリクエストが対象 新しい SDK と CLI には、3つとも無い 今ココ temperature 4/16
5. ▪効き目がなくなるのは、ほかの値を受け付けていたモデル どのモデルで変わるか Claude . 以降のモデルなど Claude Sonnet . など もともと既定値しか 受け付けない ほかの値も 受け付けていた これまでと同じように 動く 温度を下げて答えをそろえる 設定が、効かなくなる 今ココ temperature 5/16
6. ▪送るのをやめるか、そのリクエストを どう対応するか2023-06-01 に残す 既定以外の値に頼っているリクエストは、どちらかを選ぶ（公式の移⾏ガイド） ① 3つを送るのをやめる ② そのリクエストを 2023-06-01 に残す 新しい SDK に上げるなら、こちら これまでどおり温度を指定できる 2026-10-21 に上げて、 既定値（温度 1.0）で動かす SDK なら、いまのメジャー版のまま 直接なら、ヘッダーを 2023-06-01 のまま 公式のページに書かれていないこと ‧2023-06-01 を、いつまで使えるか ‧temperature などを受け付けなくした理由 今ココ temperature 6/16
7. ▪assistantMessages API のほかの変更 の document と、user の citations が 400 assistant の document ブロック user の text の citations assistant メッセージに document を直接置く → 400 user の text ブロックに citations を付ける → 400 document は user メッセージで送る その citations を外す web fetch の結果のように、 ほかのブロックの中にあるなら そのまま受け付ける assistant の text の citations と、 "citations": {"enabled": true} は そのまま受け付ける 今ココ API のほかの変更 7/16
8. ▪レスポンスから、古い名前がなくなる Admin API のフィールド名 エンドポイント RBAC グループ RBAC グループのメンバー RBAC ロール 組織‧ワークスペースのレート制限 API キー Claude Enterprise Analytics API ユーザーごとの使⽤量‧コスト アクティビティの要約 今ココ API のほかの変更 これまで roles group_id name group_type workspace_id - role_ids rbac_group_id display_name group.type scope actor.email summaries actor.email_address data 8/16
9. ▪X-Api-KeyAPIから Authorization: キーの送り方 Bearer へ これまでの SDK‧CLI 新しい SDK‧CLI X-Api-Key: <key> Authorization: Bearer <key> Claude API は、どちらのヘッダーのキーも受け付ける API に直接つないでいるプログラムは、変えなくてよい X-Api-Key を読むプロキシやゲートウェイは、直す Authorization を読むようにするか、SDK の側でキーを X-Api-Key で送る 今ココ SDK の変更 9/16
10. ▪型が User・Assistant・System MessageParam が役割ごとに の3つに分かれる MessageParam UserMessageParam AssistantMessageParam SystemMessageParam BetaMessageParam も同じように3つに分かれる 送るリクエストの中⾝は、これまでと同じ（変わるのは型） Python‧TypeScript で {"role": "user", "content": "Hello"} と書いていれば、そのまま Python で MessageParam(role=..., content=...) と呼ぶと TypeError TypeScript では、MessageParam を extends した interface が通らない 今ココ SDK の変更 10/16
11. ▪Text Completions・Models SDK からなくなったもの の betas・クライアント側の圧縮 Text Completions（client.completions） TypeScript‧Go‧Java‧Ruby の SDK と CLI から。Messages API に移る ベータでない Models のメソッドの betas client.models では受け付けない。client.beta.models を使う ツールランナーのクライアント側の圧縮 TypeScript‧Ruby。サーバー側の圧縮（compaction）に置き換え 今ココ SDK の変更 11/16
12. ▪SDK とライセンスが Apache 2.0 に CLI は MIT から Apache License 2.0 へ これまでの版 MIT License この版から Apache License . SDK と CLI の両⽅。前の版は MIT のまま コードの変更は要らない 依存しているもののライセンスを管理しているなら、記録を更新する TypeScript‧C# のほかのパッケージ（Bedrock ⽤など）は、それぞれの 1.0.0 で切り替わる Java は com.anthropic のすべてのアーティファクトが対象 今ココ SDK の変更 12/16
13. ▪送っているパラメーター・キーのヘッダー・古いフィールド名 上げる前に確かめること temperature‧top_p‧top_k を送っていないか 送っているなら外すか、そのリクエストは 2023-06-01 に残す X-Api-Key を読んでいる所がないか プロキシやゲートウェイは、Authorization を読むように直す Admin API の古いフィールド名を読んでいないか roles‧group_id‧name‧group_type‧workspace_id など 今ココ まとめ 13/16
14. ▪temperature まとめ は送るとエラー。頼っているなら 2023-06-01 に残す temperature‧top_p‧top_k は送ると 400 API SDK を上げると、版も 2026-10-21 に上がる SDK キーの送り⽅‧型‧ライセンスも変わる その他 既定値でもエラー。送らなければ温度 1.0 で動き、代わりの設定は無い 値に頼るリクエストは、外すか 2023-06-01 に残す Authorization: Bearer、役割ごとの MessageParam、Apache . 今ココ まとめ 14/16
15. ▪一度止めて考えてみてください。答えは次のページで 今回のクイズ 2026-10-21 で、temperature を既定値の 1.0 のまま送るとどうなる？ A そのまま受け付けられ る 今ココ まとめ B 400 エラーになる C 無視されて、温度 1.0 で動く D 警告が付いて、温度 1.0 で動く 15/16
16. ▪2026-10-21クイズの答えは「B」 では、既定値でも送るだけで 400 になる 今回のクイズ 2026-10-21 で、temperature を 既定値の 1.0 のまま送ると どうなる？ 2026-10-21 では、3つのどれかを 送るだけで、既定値でも 400 エラーが返る 答えは B 今ココ まとめ A そのまま受け付けられる 既定値でも受け付けない エラーになる B 400 値に関係なく、送ると 400 1.0 で動く C 無視されて、温度 無視はされず、リクエストがエラーになる 1.0 で動く D 警告が付いて、温度 警告ではなく、エラーで⽌まる 16/16