Правила использования API
Технические правила ключей, баланса, лимитов и ошибок.
1. Ключи
Ключи персональны. Не публикуйте их в клиентском коде, репозиториях и логах.
При компрометации отключите старый ключ в кабинете и выпустите новый.
На аккаунт действует общий баланс и не больше десяти активных ключей.
2. Баланс и резерв
Перед дорогим запросом может резервироваться прогнозная стоимость по max_tokens.
После ответа выполняется финальный расчёт по фактическим токенам, неиспользованная часть резерва возвращается.
3. Лимиты и ошибки
Частотный лимит применяется по ключу. Нехватка токенов определяется по общему балансу аккаунта.
Основные коды: invalid_api_key, insufficient_quota, model_not_found, rate_limit_exceeded, upstream_error, upstream_timeout.
Поле billing сообщает, были ли списаны токены. Заголовок X-Request-ID подходит для обращения в поддержку.
4. Совместимость
Endpoint совместим с форматом OpenAI: достаточно заменить base URL и ключ в поддерживаемом клиенте.
Потоковые ответы и вызовы инструментов доступны у моделей и клиентов, которые их поддерживают.
Редакция от 30 сентября 2026 года. Актуальная версия доступна на этой странице.