メインコンテンツへスキップ
見出し画像

Claude API 2026-10-21版:temperature等は400エラーに

    ※この記事は、公開情報(出典は末尾)と、俺の感想です。AIの補助で書いています。

    Anthropicの公式ドキュメントに、2026年10月21日付の新しいAPIバージョン「2026-10-21」が載っていました。リリースノートでは、SDKも同日に新しい版が出ています。

    俺はコードを書けませんが、Claude Codeでアプリを作っています。APIを直接触る人向けの話が中心ですが、「何が変わったか」を、書かれている範囲で整理します。

    先に大事なこと

    公式の移行ガイドは、旧バージョン 「2023-06-01」 から 「2026-10-21」 への移行を説明するものです。SDKを使っている場合は、そのメジャー版が出た時点のAPIバージョンで動く、と書かれています。つまり、SDKを新しい版に上げたときに、挙動が変わる可能性があります。

    Messages APIで変わること

    バージョン履歴のページに、次の3点が書かれていました。

    • assistantメッセージの中に、documentブロックを直接置くと、400エラーになる。

    • userメッセージの中の、textブロック(またはsearch_resultブロックの中)に、中身のあるcitationsを付けると、400エラーになる。

    • 「temperature」「top_p」「top_k」が削除された。どれか1つでも送ると、全モデルで400エラーになる。

    移行ガイドには、これらを送らない場合は、既定の値(temperatureは1.0)で動く、とあります。Claude 4.7以降のモデルは、もともと既定値しか受け付けないので、動きは変わらないそうです。一方、Claude Sonnet 4.6のように、ほかの値を受け付けるモデルでは、temperatureを下げて出力を安定させていた効果がなくなる、と書かれています。

    どうしても非既定の値に頼る場合は、そのリクエストだけ 「2023-06-01」 のままにする、という案内もありました。

    SDKとCLIの新しい版

    リリースノート(10月21日)に、新しいSDKとCLIが、この新バージョンを既定で送ると書かれていました。

    • Python 2.0.0

    • TypeScript 1.0.0

    • C# 13.0.0

    • Go 2.0.0

    • Java 3.0.0

    • PHP 1.0.0

    • Ruby 2.0.0

    • antCLI 2.0.0

    どれも、互換性を壊す変更を含む、と書かれています。ライセンスも、MITからApache 2.0に変わります。移行ガイドによると、以前の版はMITのままで、ライセンスの管理をしている人は、依存関係の記録を更新する必要があります。コードの修正は要らない、とあります。

    antCLIでは、「--api-key」と「--auth-token」のフラグが削除されました。コマンドラインに書いた値は、シェルの履歴やプロセス一覧から見えるため、という理由が書かれています。

    管理用API(Admin API)の名前の変更

    組織の管理用APIでも、項目の名前が変わっています。

    • RBACグループの 「roles」 は、「role_ids」 を使う。

    • RBACグループのメンバーの 「group_id」 は、「rbac_group_id」 を使う。

    • RBACロールの 「name」 は、「display_name」 を使う。

    • レート制限の 「group_type」 は、「group.type」 を使う。

    • APIキーの 「workspace_id」 は、「scope.workspace_id」 を使う。

    確認できなかったこと

    • 旧バージョン 「2023-06-01」 がいつまで使えるかは、俺が読んだ範囲では書かれていませんでした。

    • Claude Code本体に、この変更がどう関わるかは、書かれていませんでした。

    • 移行ガイドは長く、SDK別の細かい変更点は、すべては読んでいません。

    俺が気になった点

    「これまで動いていたコードが、ある日400エラーになる」ことが、いちばん困る点だと思いました。今回は、バージョンを上げたときに初めて起きる形で、SDKを上げるタイミングが分かれ目になりそうです。これは俺の読み方です。

    コードを書けない俺は、AIに書いてもらったコードの中に「temperature」が入っていないか、自分では見つけられません。AIに「このプロジェクトでtemperature、top_p、top_kを使っている箇所はあるか」と聞くのは、できそうな確認だと思いました。

    今日からできること

    • Anthropicの移行ガイド(出典のリンク)を、一度、原文で読む。

    • APIを使うアプリを作っている人は、SDKを上げる前に、「temperature」「top_p」「top_k」を使っている箇所を探す。

    • 上げる前に、今のバージョンをメモしておく。

    新しい版に上げるかどうかは、自分のアプリに影響があるかを見てから決めればよさそうです。

    出典

    (おわり)

    俺の体験は、こちらに書いています。
    https://note.com/takaden1981/n/n079c1a8bb591

    続きは、フォローすると通知で届きます。

    #ClaudeAPI #Claude #Anthropic #API #SDK #生成AI #非エンジニア #アプリ開発 #個人開発

     
     
    電気工事士。右手の指を失い、その1年後に脳出血で左半身が麻痺。両手が不自由なまま、記憶障害の物忘れ防止アプリをAIで自作中。 ・毎朝7時: 開発日記 ・体験談: 人生のターニングポイント ・アプリ公開中: CallTimeAlert(Google Play)