AIニュース

Anthropic、Python SDKをv1.0にアップグレード HTTPレイヤーをhttpx2に刷新、非推奨APIを整理

公開日: ・出典: Anthropic公式(Claude Platform Docsリリースノート)

Anthropicは8月20日、Claude API公式Python SDKの新バージョン「v1.0」をリリースしたと、開発者向けプラットフォームのリリースノートで明らかにしました。今回のアップデートの目玉は、SDKのHTTP通信を担うライブラリを、これまでのhttpxから、API互換性を保ちながらメンテナンスが続けられている派生ライブラリ「httpx2」へ切り替えたことです。カスタムのHTTPクライアントやタイムアウト、トランスポートオブジェクトを構築する際はhttpx2ベースで書き直す必要があり、トレーシングやモック用にhttpxへパッチを当てるライブラリを利用している場合は、起動時に`httpx2.alias_httpx()`を呼び出す対応が案内されています。

v1.0ではあわせて、長らく非推奨とされていた機能がまとめて削除されました。旧世代のText Completions API、Messages系メソッドの`temperature`・`top_p`・`top_k`パラメータ、Tool Runnerのクライアント側`compaction_control`などが対象で、いずれも今後は呼び出せなくなります。非同期クライアントでは`.with_raw_response`の結果に対して`await response.parse()`を呼ぶ必要が生じたほか、`AnthropicBedrock`はAWSリージョンが未設定のまま呼び出すと、従来の`us-east-1`への自動フォールバックではなく、明示的にエラーを送出するよう仕様が変更されています。

動作要件も引き上げられ、v1.0の利用にはPython 3.10以降が必須になりました。Anthropicは、変更点をビフォー・アフターのコードサンプル付きでまとめた移行ガイドをGitHub上で公開しており、既存のSDK利用コードを更新する際の参考になるとしています。破壊的変更を伴うメジャーバージョンアップだけに、本番環境で利用している開発者は、アップグレード前に移行ガイドを確認したうえで対応することが推奨されます。

出典: Anthropic公式(Claude Platform Docsリリースノート)

Xでシェア

Python SDK、v1.0での主な変更点

Anthropic公式のPython SDKリリースノート・移行ガイドに基づき、v1.0より前とv1.0の違いをまとめました。

項目 v1.0より前 v1.0
HTTPレイヤー httpx httpx2(API互換のメンテナンスフォーク)
必要なPythonバージョン 3.10未満にも対応 Python 3.10以上が必須
Messages APIのtemperature/top_p/top_k引数 利用可能 削除され呼び出し不可に
レガシーText Completions API 利用可能 削除
AnthropicBedrockでリージョン未設定時の挙動 us-east-1に自動フォールバック 明示的にエラーを送出

※出典: Anthropic公式リリースノート / anthropic-sdk-python v1移行ガイド(GitHub)