OpenAI добавила API key dimension в Usage и Costs dashboards

4 августа 2026 года OpenAI добавила API key dimension в Usage and Costs dashboards. Та же группировка стала доступна в Usage API и Costs API для программной отчётности и анализа. Первоисточник: https://developers.openai.com/api/docs/changelog

API key dimension - это способ связать расход и usage не только с organization или project, но и с конкретным ключом доступа. Для команд, которые держат отдельные ключи для production, staging, CI, batch jobs и agent workloads, такой срез помогает быстрее понять, какой workload создаёт рост токенов, стоимости или ошибок лимитов.

Что изменилось для platform teams:

• в Usage and Costs dashboards можно фильтровать и группировать данные по API key;
• Usage API и Costs API поддерживают тот же dimension для автоматических отчётов;
• spend investigations можно привязать к ключу, окружению или сервису, если команда заранее разделила ключи по workload;
• API key dimension дополняет project-level rate limits и hard spend limits, которые OpenAI добавила в июле 2026 года;
• 429 из-за spend cap или rate limit всё равно остаётся runtime-событием, которое нужно логировать отдельно от billing dashboard.

Практический workflow: 1. Раздели API keys по окружениям и типам задач: production user traffic, internal agents, batch processing, CI. 2. Добавь API key dimension в ежедневный Usage API или Costs API отчёт. 3. Сопоставляй cost spikes с latency, 429 events, model route и fallback attempts. 4. Настрой spend alerts до hard cap, чтобы лимит не останавливал рабочий traffic внезапно. 5. Ротируй или отключай ключ только после проверки, какой сервис или агент его использует.

Use API key-level cost reporting when one organization runs several products, agents or environments on the same provider account. The safest production pattern is to combine key-level billing analytics with runtime routing, retries and failover, because dashboard visibility explains spend after the fact, while traffic control prevents user-facing failures.