OpenAI: HTTPX2 'ye geçiş

OpenAI Python SDK artık eşzamanlı ve eşzamansız HTTP istemcileri için HTTPX2 kullanıyor. HTTPX2, openai ile otomatik olarak yüklenir; önceki httpx paketi değil. Bu kılavuz, SDK'nın HTTP katmanıyla etkileşime giren uygulamalar için hangi değişiklikleri açıklamaktadır. http_client sağlamadan bir OpenAI veya AsyncOpenAI istemcisi oluşturursanız mevcut API çağrılarınız, ayrıştırılmış yanıt modelleriniz, akış API'leriniz, kimlik doğrulamanız, yeniden denemeleriniz ve sayısal zaman aşımlarınız çalışmaya devam eder: Uygulamanız httpx'i yalnızca daha önceki bir SDK'nın geçişli olarak yüklemesi nedeniyle içe aktardıysa, kendi httpx bağımlılığınızı ekleyin veya bu içe aktarmaları httpx2'ye taşıyın. SDK'yı yüklemek artık sizin için httpx'i yüklemez. HTTPX2, SDK'nın varsayılan HTTP istemcisini kullanan uygulamalar da dahil olmak üzere varsayılan TLS güven deposunu değiştirir. HTTPX daha önce sertifikaları certifi tarafından sağlanan CA paketine göre doğruladı. HTTPX2 bunun yerine işletim sisteminin güven deposunu kullanır ve SDK artık certifi yüklemez. Bu, sistem CA sertifikaları olmayan minimum kapsayıcı görüntülerinde, kurumsal TLS denetleyen proxy'leri kullanan ortamlarda ve özel veya değiştirilmiş bir sertifika paketine dayanan dağıtımlarda sertifika doğrulamasını bozabilir. Gerekli CA sertifikalarını işletim sisteminin güven deposuna yükleyin veya açık bir sertifika paketi yapılandırın: Alternatif olarak, güvenilen CA sertifikalarının bir dizinini yapılandırın: Bu ortam değişkenleri, varsayılan olan Trust_env=True olduğunda dikkate alınır.

Özel bir istemcide güveni açık bir şekilde kontrol etmek için doğrulama yoluyla bir ssl.SSLContext iletin: Eşdeğer eşzamansız yapılandırma için DefaultAsyncHttpx2Client(verify=ssl_context) öğesini kullanın. SDK'nın aiohttp aktarımı aynı HTTPX2 TLS ayarlarını kullanır. HTTPX2 istemcilerini ve HTTPX2 yapılandırma nesnelerini kullanın. SDK, önerilen zaman aşımı, bağlantı havuzu ve yönlendirme varsayılanlarını koruyan yardımcılar sağlar: Doğrudan oluşturulmuş httpx2.Client ve httpx2.AsyncClient örnekleri de desteklenir. Doğrudan bir istemci oluşturduğunuzda, kendiniz yapılandırmadığınız sürece istemcinin kendi HTTPX2 varsayılanları geçerli olur. Mevcut DefaultHttpxClient ve DefaultAsyncHttpxClient adları çalışmaya devam eder ancak artık HTTPX2 istemcileri oluşturur. HTTP istemci ailesini açık hale getirirken DefaultHttpx2Client ve DefaultAsyncHttpx2Client'i tercih edin. HTTPX'e özgü nesneleri karşılık gelen HTTPX2 nesneleriyle değiştirin: Sayısal zaman aşımı değerleri değişmez.