OpenAI Agents API Beta: Новый обход шлюза, который операторам необходимо учесть

10 сентября OpenAI запустила Agents API в публичную бету. Анонс делает упор на удобство для разработчиков — управляемые сессии, автоматическое сжатие контекста, провижининг окружений. То, что спрятано в документации, оперативно значимее: этот API не проходит через /v1/chat/completions.

Если ваша команда маршрутизирует AI-трафик через шлюз, этот шлюз сейчас слеп к каждому вызову Agents API от ваших разработчиков.

Новое пространство имён, новый маршрут

Agents API живёт в client.beta.agents.sessions — полностью отдельном пространстве имён SDK, не пересекающемся со стандартным chat или Responses API. Каждый запрос требует заголовка OpenAI-Beta: agents=v1, а API key должен включать два новых scope, которых раньше не существовало: api.agents.read и api.agents.write, плюс api.responses.write для инференса модели.

Это имеет конкретные последствия для операторов шлюзов. Большинство AI-шлюзов проксируют запросы, перехватывая обращения к OpenAI-совместимым эндпоинтам: /v1/chat/completions, /v1/responses и аналогичным путям. Agents API не использует эти пути. Сессия, созданная через client.beta.agents.sessions.create(...), идёт напрямую к управляемой harness-инфраструктуре OpenAI, минуя настроенный base URL.

Практическое следствие: разработчик, переключившийся с прямого вызова Responses API на Agents API, одновременно и беззвучно исчезнет из вашей панели мониторинга использования, трекера расходов и журнала аудита.

Три биллинговых потока от одного API-вызова

Стандартный вызов модели генерирует одно биллинговое событие: токены на входе и выходе по тарифу модели. Agents API может генерировать три:

• Инференс модели: по стандартному тарифу выбранной модели (например, тарифы GPT-6 Astra применяются при model: "gpt-6-astra")
• Использование встроенных инструментов: веб-поиск, выполнение кода, файловые операции и MCP-подключения имеют собственные строки в счёте по стандартным тарифам на инструменты OpenAI
• Вычисление контейнера: при environment.type: "openai_hosted" sandbox выставляет поминутные тарифы на контейнер поверх расходов на модель и инструменты

Один вызов sessions.create() может одновременно накопить все три. При сверке затрат в конце месяца расходы на токены модели выглядят привычно, тогда как расходы на контейнер и инструменты появляются отдельно — без привязки к задаче сессии или к члену команды, который её инициировал.

Рабочее решение сегодня — требовать от разработчиков использовать самостоятельно развёрнутые окружения (environment.type: "self_hosted"), чтобы единственным биллинговым компонентом, уходящим в OpenAI, оставался инференс модели. Его базовые вызовы можно маршрутизировать через шлюз по заданному base URL. Документация OpenAI указывает, что self-hosted режим поддерживает sandbox-провайдеров: Blaxel, Cloudflare, Daytona, E2B, Modal, Vercel и других из списка в API-справочнике.

Все три крупных провайдера теперь ушли за пределы /v1/chat/completions

Это не только история OpenAI. Anthropic запустила Managed Agents API в апреле 2026 года с собственным beta-заголовком (managed-agents-2026-04-01) и собственной структурой эндпоинтов. Google ранее в этом году выпустила Gemini Enterprise Workflow Agents на аналогично отдельном API-уровне. Теперь к ним присоединился OpenAI.

Паттерн одинаков у всех трёх: специализированный harness сессий или workflows, управляющий состоянием, контекстом и выполнением инструментов, намеренно находящийся вне стандартного completion-эндпоинта. Последствие для маршрутизации идентично: если вы полагаетесь на перехват /v1/chat/completions или его OpenAI-совместимого эквивалента, вы маршрутизируете API-поверхность 2024 года, а не ту, которая в 2027-м будет нести production-нагрузки агентов.

Позиция роутера ценна тем, что позволяет одновременно видеть этот сдвиг у всех трёх провайдеров. Команда, использующая Claude Code через TheRouter, уже в каком-то смысле работает вне стандартного пути completion — интеграция шлюза Claude Code маршрутизирует базовые API-вызовы, но слой управления agent-сессиями выше контролируется провайдером. Agents API формализует и углубляет это разделение.

Что меняется для операторов шлюзов сегодня

Непосредственные решения имеют конкретный масштаб:

Управление API key. Сессии Agents API требуют scope api.agents.read и api.agents.write. Если вы выдаёте ключи членам команды через административную панель, нужно решить: добавить эти scope к существующим ключам или создать отдельные ключи только для Agents API. Отдельные ключи дают более чистый аудит-сигнал, ценой большего числа credentials для управления.

Политика окружений. Пока вы не можете перехватывать трафик Agents API в шлюзе, переориентируйте команды на environment.type: "self_hosted" с самовыбранным sandbox-провайдером. В этом режиме базовые вызовы модели пойдут через base URL, настроенный в OpenAI client sandbox — это ваша точка входа в цепочку маршрутизации.

Атрибуция расходов. Добавьте страницу ценообразования контейнеров Agents API в чеклист ежемесячной сверки биллинга. Расходы на контейнер не появляются в той же строке, что и токены модели. Команды, запускающие многочасовые задачи в hosted-sandbox, увидят заметно иную форму счёта по сравнению с Responses API.

Мониторинг изменений. OpenAI явно указала статус публичной беты OpenAI-Beta: agents=v1. Бета-статус означает, что контракт эндпоинта может меняться без стандартного цикла устаревания. Включите OpenAI SDK changelog и API-справочник в регулярный мониторинг.

На что обратить внимание пользователям TheRouter

Для команд, уже маршрутизирующих трафик OpenAI через TheRouter: существующие конфигурации маршрутизации продолжают работать для chat completions и Responses API. Agents API требует прямых credentials OpenAI с новыми scope — прозрачное проксирование сейчас невозможно.

Следите за OpenAI API changelog: когда Agents API выйдет из беты и появится ли для него OpenAI-совместимый слой маршрутизации. Параллельно на стороне Anthropic стоит отслеживать команду ant beta:sessions connect, вышедшую вместе с обновлением платформы 10 сентября, — она добавляет подключение терминала к Managed Agents сессиям. Это признак того, что оба провайдера строят инструменты для наблюдения за agent-сессиями вне стандартного API event stream.

Практический ориентир по тому, что TheRouter маршрутизирует сегодня: всё, что течёт через /v1/chat/completions, /v1/responses или совместимые эндпоинты — инференс модели, потоковую передачу, fallback, учёт расходов. Agent session harness от любого провайдера требует собственной инфраструктуры credentials и собственной стратегии наблюдаемости.