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 на верхнем уровне.
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; подробности приведены в справочнике ошибок.
После успешного короткого вызова проверьте задачу с реальным размером входа, затем ограниченную очередь. Ставки смотрите на странице цен, фактический расход в журнале кабинета. Успешный короткий ответ проверяет соединение, но ещё не показывает стоимость обработки длинного документа.
FAQ
Google AI Studio: лимиты совпадают с ограничениями Relay?
Нет. Квота проекта Google и ограничения ключа и аккаунта Relay учитываются в разных системах. Проверяйте ответы того адреса, куда отправляет запрос приложение.
Поможет ли новый ключ Google при исчерпании квоты проекта?
Ограничения Gemini API применяются к проекту. Не рассчитывайте получить независимую квоту одной заменой ключа в том же проекте.
Повышает ли оплата Relay лимиты Google?
Нет. Она пополняет баланс Relay для запросов к его API. Квоты проекта Google меняются по условиям Google.
Почему 402 приходит после пополнения баланса?
Прочитайте код: причиной может быть лимит расходов ключа или ограничение нового аккаунта. Само пополнение не снимает любой денежный отказ.