OpenAI Python SDK 2.x: новые возможности и GPT-5.5 в API

OpenAI Python SDK перешёл на версию 2.x — что изменилось

Официальная Python-библиотека OpenAI предоставляет удобный доступ к REST API из любого приложения на Python 3.9+. Библиотека включает типизацию всех параметров запросов и полей ответов, а также синхронный и асинхронный клиенты на базе httpx. При этом репозиторий уже достиг версии 2.x — крупное обновление, которое принесло ряд принципиальных изменений в архитектуру и возможности SDK.

pip install openai

Responses API — новый основной интерфейс

Основным API для работы с моделями OpenAI теперь является Responses API. Именно его рекомендует использовать команда OpenAI для новых проектов вместо привычного Chat Completions API.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("OPENAI_API_KEY"),
)

response = client.responses.create(
    model="gpt-5.5",
    instructions="You are a coding assistant that talks like a pirate.",
    input="How do I check if a Python object is an instance of a class?",
)

print(response.output_text)

Chat Completions API по-прежнему поддерживается и будет доступен бессрочно — но именно Responses API получает все новые возможности платформы.

Модель GPT-5.5 как стандарт в примерах

GPT-5.5 — большая языковая модель, выпущенная OpenAI 23 апреля 2026 года. Она отлично справляется с написанием и отладкой кода, поиском в интернете, анализом данных, созданием документов и таблиц, управлением программным обеспечением.

GPT-5.5 выпущен в Chat Completions и Responses API и поддерживает контекстное окно в 1 млн токенов, ввод изображений, структурированные выходные данные, function calling, поиск, встроенное управление компьютером и веб-поиск.

GPT-5.5 — самая умная и интуитивная модель OpenAI на сегодняшний день, следующий шаг к новому способу работы на компьютере.

Сравнение: Responses API vs Chat Completions API

Workload Identity — безопасная аутентификация без ключей

В защищённых автоматизированных окружениях — Kubernetes, Azure и Google Cloud Platform — теперь можно использовать Workload Identity Authentication с краткосрочными токенами вместо долгоживущих API-ключей.

Поддерживаются три провайдера из коробки:

• Kubernetes — через сервисный аккаунт (k8s_service_account_token_provider)
• Azure — через управляемое удостоверение (azure_managed_identity_token_provider)
• Google Cloud Platform — через метаданные Compute Engine (gcp_id_token_provider)

Также доступна реализация произвольного провайдера через кастомную функцию get_token.

Асинхронный режим и aiohttp

Для асинхронной работы достаточно импортировать AsyncOpenAI вместо OpenAI и использовать await.

import asyncio
from openai import AsyncOpenAI

client = AsyncOpenAI()

async def main() -> None:
    response = await client.responses.create(
        model="gpt-5.5",
        input="Explain disestablishmentarianism to a smart five year old."
    )
    print(response.output_text)

asyncio.run(main())

Для повышенной производительности под нагрузкой можно подключить бэкенд aiohttp:

pip install openai[aiohttp]

Realtime API — голос и текст в реальном времени

Поддержка Realtime API была добавлена в Python SDK. Realtime API мигрировал на модель gpt-realtime и её GA-интерфейс.

Realtime API позволяет строить разговорные мультимодальные приложения с низкой задержкой через WebSocket. Поддерживаются текст и аудио как на входе, так и на выходе, а также function calling.

Схема работы SDK

graph TD
    A[Python-приложение] --> B[OpenAI / AsyncOpenAI клиент]
    B --> C{Выбор API}
    C -->|Основной| D[Responses API]
    C -->|Legacy| E[Chat Completions API]
    C -->|Реальное время| F[Realtime API WebSocket]
    D --> G[GPT-5.5 / gpt-5.5]
    E --> G
    F --> H[gpt-realtime]
    B --> I[Workload Identity]
    I --> J[Kubernetes / Azure / GCP]

Контекст: куда движется экосистема OpenAI

SDK 2.x появился на фоне стремительного развития модельного ряда OpenAI. GPT-5.6 был публично выпущен 9 июля 2026 года и поставляется в трёх вариантах: Sol (мощный), Terra (сбалансированный) и Luna (экономичный). Компания заявляет, что Sol уже доступен через ChatGPT, Codex и OpenAI API.

Библиотека в целом следует соглашениям SemVer, хотя отдельные обратно несовместимые изменения могут выходить в рамках минорных версий.

Полная документация по API доступна на platform.openai.com, а исходный код — на GitHub.