OpenAI Python SDK: оновлення за 21–22 жовтня 2026

Коротко

Цього тижня для офіційної бібліотеки OpenAI Python вийшли релізи 3.36.0, 3.36.1 та 3.37.0. Головними оновленнями стали додавання підтримки Vertex AI для Responses API, підрахунок використання 30-хвилинного кешування запису, керування згодою для Custom Voice та розширення типів у Decisions API. Версія 3.37.0 містить ламаючі зміни в типізації відповідей та вхідних даних для Decisions.

Нові можливості

Підтримка хмарних платформ та нові параметри API

• Підтримка Vertex AI для Responses API: додано можливість використовувати Vertex AI разом із Responses API.
• Підрахунок використання cache-write: додано метрики використання для 30-хвилинного запису в кеш (30-minute cache-write usage counts).
• Ідентифікатори тригерів стиснення: у запити API додано підтримку compaction trigger IDs.
• Керування згодою для Custom Voice: додано функціональність керування згодою для користувацьких голосів (custom voice consent management).

Робота з типами та WebSocket

• Підготовка нативних синхронних опцій WebSocket: у модуль types додано підготовлений тип нативних опцій для синхронних WebSocket-з'єднань (native synchronous WebSocket option type).
• Розширення типів для Decisions: розширено типи вхідних даних і запитань для Decisions API (детальніше про зміну поведінки структури типів дивіться в розділі про ламаючі зміни).

Ламаючі зміни

У версії 3.37.0 внесені несумісні зміни до типів Decisions API:

• Зміна типу instructions у моделях відповідей Live: поле запитання instructions тепер може бути не лише рядком, а й списком структурованих частин із текстом, зображеннями або JSON. Перед викликом рядкових методів необхідно перевіряти тип через isinstance(question.instructions, str) та обробляти структурований формат. При цьому звичайні рядкові інструкції продовжують підтримуватися.
• Розширення типів вхідних даних Decisions: типи запитів отримали додаткові ролі повідомлень та елементи історії інструментів (tool-history items), через що потрібно оновити вичерпні перевірки типів (exhaustive type checks). Раніше використовувані повідомлення користувача типу DecisionInputMessageParam залишаються сумісними.

Виправлення та покращення

• Робота з WebSocket та Realtime:
  • Очищення стану в разі невдалого налаштування WebSocket зі збереженням нативних опцій.
  • Зупинка відновлення синхронного WebSocket (sync WebSocket recovery), якщо спробу було перервано.
  • Збереження стану закриття WebSocket під час відновлення та скасування з'єднання.
  • Збереження клієнтських заголовків у застарілих з'єднаннях Beta Realtime, а також підтримка нативних опцій для legacy beta sockets.
  • Врахування індивідуальних параметрів WebSocket-запиту для кожного окремого виклику (per-call WebSocket query settings).
• Робота з API та моделями:
  • Прийом канонічних відповідей Batch API у строгому режимі (strict mode).
  • Збереження оголошених псевдонімів (aliases) під час валідації через Pydantic v1.
  • Збереження кореневого шляху Vertex API (Vertex API root) протягом життєвого циклу відповіді.
  • Коректне врахування часу отримання Translation під час фінального очищення ресурсів (terminal cleanup).
• Інструменти та приклади:
  • Додано валідацію браузерних викликів перед читанням стану драйвера.
  • У прикладах реалізовано зупинку захоплення звуку з мікрофона між сесіями запису.

Версії тижня

• 3.36.0 — 2026-10-21
• 3.36.1 — 2026-10-22
• 3.37.0 — 2026-10-22