К содержимому
Блог

Google AI Studio лимиты: как отделить их от API Relay

Google AI Studio лимиты: как отделить их от API Relay

Google AI Studio: лимиты нужно проверять для выбранного проекта и модели, а не искать одну цифру на все запросы. В Gemini API ограничения включают запросы в минуту, входные токены в минуту и запросы за сутки; действующие значения показывает AI Studio. Переход на Relay создаёт отдельный путь доступа с ключом Relay и собственными ограничениями. Он не повышает квоту вашего проекта Google.

Google AI Studio: лимиты какого проекта вы проверяете

Откройте активные ограничения в Google AI Studio и убедитесь, что выбран тот проект, от которого отправляет запрос приложение. Сверьте модель и тип исчерпанной квоты. В Gemini API ограничения применяются к проекту, поэтому создание ещё одного ключа в том же проекте не даёт оснований ожидать отдельную квоту.

Различайте число запросов и объём входа. Несколько больших документов способны исчерпать токенный лимит при небольшом числе вызовов. Частые короткие вопросы могут упереться в ограничение частоты. Сохраните фактическое сообщение об отказе, прежде чем уменьшать или увеличивать нагрузку.

Не копируйте квоты из чужой таблицы как действующие значения своего аккаунта. Они зависят от проекта, модели и уровня использования. Точные числа, доступность и условия изменения квот сверяйте в интерфейсе Google и его руководстве Gemini API.

Что меняется при переносе запроса на Relay

Relay использует собственный ключ и каталог. Например, gemini-3.1-pro и gemini-3.8-flash доступны в каталоге Relay. Для OpenAI-совместимого сценария базовый адрес https://relay-llm.ru/v1. Параметры Google SDK не нужно просто копировать в тело Chat Completions: у протоколов различается структура запроса.

Перед переносом выпишите текст, системную инструкцию и ожидаемый результат. Затем соберите минимальный вызов по документации Chat Completions. Возможности интерфейса AI Studio, история сессии и квота Google автоматически вместе с ним не переносятся.

Настройки обработки документов тоже проверьте отдельно. Текстовый вызов ниже не подтверждает поддержку файлов, аудио или другого входа: для каждого типа нужно своё документированное поле и отдельный тест.

Как выполнить минимальный запрос на Node.js

Сохраните пример как check-gemini.mjs в окружении с доступным пакетом openai. Передайте ключ Relay в RELAY_API_KEY и запустите node check-gemini.mjs. Файл использует модульный импорт, поэтому его можно запускать с await на верхнем уровне.

javascript
const { default: OpenAI } = await import('openai')

if (!process.env.RELAY_API_KEY) {
  throw new Error('Задайте RELAY_API_KEY в окружении процесса')
}
const client = new OpenAI({
  apiKey: process.env.RELAY_API_KEY,
  baseURL: 'https://relay-llm.ru/v1',
  maxRetries: 0,
})
try {
  const reply = await client.chat.completions.create({
    model: 'gemini-3.8-flash',
    messages: [{ role: 'user', content: 'Объясни RPM одним предложением.' }],
    max_tokens: 128,
  })
  const text = reply.choices[0]?.message.content
  if (!text) throw new Error('Нет текстового ответа')
  console.log(text)
} catch (error) {
  if (error instanceof OpenAI.APIError) {
    console.error('HTTP:', error.status, 'код:', error.code)
    console.error('Retry-After:', error.headers?.get('retry-after'))
    console.error('x-request-id:', error.headers?.get('x-request-id'))
  }
  throw error
}

Автоповторы SDK в этом диагностическом примере отключены: один запуск соответствует одной попытке приложения. Он помогает увидеть исходный отказ. Для рабочего процесса повторы настройте отдельно по правилам Relay, ограничив их число и общий срок.

Какие ограничения Relay отличаются от квот Google

У Relay частота запросов проверяется по ключу и аккаунту. Отказывает счётчик, который исчерпан раньше. Поэтому второй ключ того же аккаунта не устраняет общий предел аккаунта. Действующий предел запросов показывает заголовок x-ratelimit-limit-requests ответа на запрос к модели.

У нового аккаунта есть дополнительные ограничения. Поле rate_limit_rpm в GET /v1/key учитывает настройки ключа и группы, но не ограничения нового аккаунта, поэтому может показывать число выше фактически действующего. Подробности есть в документации лимитов.

Ограничение одновременности применяется к потокам и медиа; обычный текстовый запрос без потока такой слот не занимает. Денежные отказы идут отдельно от частоты: 402 может означать недостаточный баланс, лимит расходов ключа или ограничение нового аккаунта.

Как действовать по фактическому коду ошибки

Код RelayДействие
402 insufficient_balanceПроверьте доступный баланс и резерв
402 key_limit_exceededПроверьте общий, дневной и месячный лимиты ключа
402 new_account_limitСверьте ограничения нового аккаунта
429 rate_limitedСоблюдайте Retry-After, уменьшите частоту
429 concurrency_limitУменьшите число одновременных потоков или медиа
404 model_not_foundПроверьте точный ID модели

Повторяйте запрос только при x-should-retry: true, выдерживая Retry-After, если он есть. Отсутствие денег не исправляется паузой. Сохраните статус, код и x-request-id; подробности приведены в справочнике ошибок.

После успешного короткого вызова проверьте задачу с реальным размером входа, затем ограниченную очередь. Ставки смотрите на странице цен, фактический расход в журнале кабинета. Успешный короткий ответ проверяет соединение, но ещё не показывает стоимость обработки длинного документа.

Gemini 3.8 Flash0,20 $ за 1 млн входных токенов

FAQ

Google AI Studio: лимиты совпадают с ограничениями Relay?

Нет. Квота проекта Google и ограничения ключа и аккаунта Relay учитываются в разных системах. Проверяйте ответы того адреса, куда отправляет запрос приложение.

Поможет ли новый ключ Google при исчерпании квоты проекта?

Ограничения Gemini API применяются к проекту. Не рассчитывайте получить независимую квоту одной заменой ключа в том же проекте.

Повышает ли оплата Relay лимиты Google?

Нет. Она пополняет баланс Relay для запросов к его API. Квоты проекта Google меняются по условиям Google.

Почему 402 приходит после пополнения баланса?

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

Создать аккаунт

Модели из статьи

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.