OpenAI Python SDKがHTTPX2へ移行：開発者が知るべき認証・環境設定の変更点
OpenAI Python SDKは、同期および非同期のHTTPクライアントとして、次世代のHTTPクライアントライブラリであるHTTPX2への移行を完了しました。この変更は、SDKのAPI呼び出し、ストリーミング、認証、リトライ、タイムアウトなどの既存の機能が継続して動作することを保証しつつ、開発者にいくつかの重要なコードおよび環境設定の変更を要求します。
**【変更の概要と影響】**
最も重要な変更点は、TLS証明書の検証方法です。以前は`certifi`が提供するCAバンドルを使用して証明書を検証していましたが、HTTPX2では代わりにオペレーティングシステム（OS）のトラストストアを使用するようになりました。この変更により、システムCA証明書がない最小コンテナイメージ、企業が利用するTLSインスペクションプロキシ環境、またはカスタムの`certifi`バンドルに依存していたデプロイメントでは、証明書検証が失敗する可能性があります。
**【対応策】**
開発者は、OSのトラストストアに必要なCA証明書をインストールするか、環境変数`SSL_CERT_FILE`または`SSL_CERT_DIR`を設定して明示的な証明書バンドルを指定する必要があります。また、コードレベルでは、古い`httpx`オブジェクトではなく、新しい`httpx2`オブジェクト（例：`httpx2.Client`）を使用するように更新することが推奨されます。SDKは`DefaultHttpx2Client`などのヘルパーを提供していますが、カスタムの認証ハンドラやトランスポートを実装する際は、対応する`httpx2`クラスを継承する必要があります。
**【技術的な注意点】**
移行に伴い、SDKの依存関係の管理も変更され、以前のように`httpx`が自動的にインストールされるわけではありません。また、モックテストやカスタムトランスポートを実装する場合も、すべてHTTPX2のインターフェースに対応させる必要があります。レガシーな`httpx`クライアントを意図的に使用する場合は、`typing.cast`などの型キャストによる回避策が必要となり、これは一時的な移行措置として提供されています。
背景
OpenAI SDKは、基盤となるHTTPクライアントライブラリを、より現代的で安定した次世代ライブラリであるHTTPX2に移行しました。この移行は、単なるライブラリの更新ではなく、セキュリティ基盤（TLS証明書検証）の仕組みそのものに大きな変更をもたらすため、利用者は環境変数やコードの修正が必須となります。
重要用語解説
- HTTPX2: Python向けの次世代HTTPクライアントライブラリ。HTTP/1.1とHTTP/2の両方をサポートし、同期・非同期APIを提供することで、OpenAI SDKの基盤として採用されました。
- certifi: 以前のSDKが使用していた証明書検証ライブラリ。CAバンドル（認証局の証明書群）を提供することで、TLS接続のセキュリティを確保していましたが、新バージョンではOSのトラストストアに置き換わりました。
- TLS trust store: オペレーティングシステムが管理する信頼された認証局（CA）の証明書群。HTTPX2が採用した仕組みであり、システムレベルで証明書検証を行うため、環境設定がより重要になりました。
今後の影響
開発者にとっては、コードベース全体におけるHTTPクライアント関連のインポートとオブジェクトの更新作業が必須となります。特に、コンテナ環境や企業ネットワークのプロキシを経由する場合、OSレベルでのCA証明書管理が崩れるリスクがあるため、環境設定の確認と修正が最優先事項となります。