Share
Embed
Video
Transcript
16 slides
-
▪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 -
▪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 -
▪既定値でもエラー。送らなければ温度 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 -
▪効き目がなくなるのは、ほかの値を受け付けていたモデル どのモデルで変わるか Claude . 以降のモデルなど Claude Sonnet . など もともと既定値しか
受け付けない ほかの値も 受け付けていた これまでと同じように 動く 温度を下げて答えをそろえる 設定が、効かなくなる 今ココ temperature 5/16 -
▪送るのをやめるか、そのリクエストを どう対応するか2023-06-01 に残す 既定以外の値に頼っているリクエストは、どちらかを選ぶ(公式の移⾏ガイド) ① 3つを送るのをやめる ② そのリクエストを 2023-06-01 に残す
新しい SDK に上げるなら、こちら これまでどおり温度を指定できる 2026-10-21 に上げて、 既定値(温度 1.0)で動かす SDK なら、いまのメジャー版のまま 直接なら、ヘッダーを 2023-06-01 のまま 公式のページに書かれていないこと ‧2023-06-01 を、いつまで使えるか ‧temperature などを受け付けなくした理由 今ココ temperature 6/16 -
▪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 -
▪レスポンスから、古い名前がなくなる 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 -
▪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 -
▪型が 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 -
▪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 -
▪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 -
▪送っているパラメーター・キーのヘッダー・古いフィールド名 上げる前に確かめること temperature‧top_p‧top_k を送っていないか 送っているなら外すか、そのリクエストは 2023-06-01 に残す X-Api-Key を読んでいる所がないか プロキシやゲートウェイは、Authorization
を読むように直す Admin API の古いフィールド名を読んでいないか roles‧group_id‧name‧group_type‧workspace_id など 今ココ まとめ 13/16 -
▪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 -
▪一度止めて考えてみてください。答えは次のページで 今回のクイズ 2026-10-21 で、temperature を既定値の 1.0 のまま送るとどうなる? A そのまま受け付けられ る
今ココ まとめ B 400 エラーになる C 無視されて、温度 1.0 で動く D 警告が付いて、温度 1.0 で動く 15/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