Свои Google API-ключи и расчёт квоты
Проверено 20 сентября 2026 года. Продукт Croscor Translate, веб-бета VADMAX.
Что доступно в приложении
Откройте настройки разговора, затем "Свои Google API-ключи". Можно сохранить до 20 ключей и вручную выбрать активный. Добавление ключа не увеличивает баланс минут. Озвучка изначально выключена; ранее выбранная пользователем настройка сохраняется.
По умолчанию собственный ключ обслуживает только запросы его владельца. После отдельного разрешения владельца ключ может участвовать в общей ротации приглашённой группы. Сервис не берёт плату за этот режим в текущей бете. Расходы Google относятся к проекту владельца. В общий пул попадают только ключи с отдельным согласием владельцев. Обычные посетители сайта не используют этот пул.
Почему не обещаем 15 бесплатных минут за ключ
Google применяет ограничения к проекту, а не к отдельному ключу. Несколько ключей одного проекта не складывают RPM, TPM или дневной лимит. Актуальные значения видны в AI Studio; они различаются по модели и тарифу и не гарантируют постоянную доступность.
Условия Google требуют Paid Services для приложений, доступных пользователям ЕЭЗ, Великобритании и Швейцарии. В определении Google это Gemini API через проект с активным Cloud Billing. Поэтому для нашей международной веб-версии, включая Испанию, подключение личного проекта требует подтверждения активного биллинга. Автоматическую проверку биллинга API-ключ не предоставляет. Наличие ключа и ответ каталога сами по себе не подтверждают биллинг или доступную квоту.
В таблице Google есть бесплатные квоты для выбранных моделей. Это не отменяет территориальные условия. Кредиты можно учитывать только после проверки их применимости к Gemini API в конкретном аккаунте. Подписка Gemini/Antigravity не является доказательством наличия API-кредитов.
Подключение
- Откройте https://aistudio.google.com/api-keys под своим Google-аккаунтом.
- Выберите отдельный проект для переводчика и создайте API-ключ. Никому не отправляйте его в чат.
- Проверьте Cloud Billing и доступные квоты выбранных моделей. Установите бюджетные уведомления Google Cloud. Уведомление не является жёстким ограничителем расходов.
- Ограничьте ключ только Gemini API в AI Studio. Для этого серверного подключения ограничение по HTTP-referrer сайта не подходит. При желании IP-ограничение должно соответствовать исходящему IP сервера и требует отдельной проверки.
- В приложении откройте настройки, затем "Свои Google API-ключи". Назовите ключ, вставьте его и подтвердите принадлежность, хранение и биллинг.
- "Проверить и сохранить" проверяет доступ к каталогу без генерации контента. Затем нажмите "Использовать". Доступ к Live-модели проверяется при запуске микрофона; Google может ограничить его отдельно.
- Дополнительные ключи добавляются так же. В личном режиме выбор ручной. В общем пуле ключи чередуются, а после серверной ошибки 429 применяется пауза; квоты Google не увеличиваются числом ключей. После ошибки 429 дождитесь восстановления соответствующей квоты.
- Удалить ключ из приложения можно в том же окне. Для полного отзыва, в том числе уже выданных разрешений, удалите ключ в Google AI Studio и остановите активные сеансы. Удаление из приложения не отзывает его в Google.
В режиме своего ключа доступны Live, перевод введённой фразы и Google-озвучка, если включить её вручную. Старые аудиорежимы и AI-ассистент требуют отдельного переключения на ключи сервиса; скрытого перехода на общие платные ключи нет.
Общий пул для своих
- Получите код приглашения у организатора. В настройках ключей введите его в разделе "Общий пул для своих".
- Сохраните свой Google-ключ обычным способом. Он останется личным, пока вы не разрешите общее использование.
- В карточке ключа укажите настоящий Google Cloud Project ID из AI Studio, например my-translator-123. Это идентификатор проекта, не произвольное название.
- Нажмите "Разрешить общий доступ" и подтвердите, что приглашённые участники могут расходовать квоту вашего проекта и создавать расходы Google. Согласие записывается отдельно для каждого ключа.
- Чтобы переводить через ключи группы, нажмите "Использовать общий пул". Участнику необязательно делиться собственным ключом. В общем режиме доступны Live, перевод текста и Google-озвучка при её ручном включении.
- "Убрать из общего пула" прекращает новые обращения к этому ключу со стороны группы. Ключ остаётся сохранённым для личного использования. "Выйти из группы" отзывает участие всех ваших ключей; "Удалить" удаляет выбранную запись из приложения.
Чужие ключи, их владельцы и история реплик не показываются участникам. Текст и аудио обрабатываются Google в проекте выбранного ключа, поэтому участники должны доверять его владельцу и настройкам проекта. Новый Live-сеанс проходит через сервер приложения. Отзыв ключа или выход из аккаунта закрывает управляемое соединение при ближайшей проверке, обычно в течение секунды. Выполняющийся запрос Google и старые прямые разрешения нельзя отозвать мгновенно; для полного отзыва используйте Google AI Studio.
Пауза после HTTP 429 сохраняется при перезапуске и объединяет ключи по указанному Project ID для соответствующей модели. Project ID вводит владелец: приложение пока не проверяет его через Google Cloud. После первого разрешения поле закреплено за ключом. Вводите один настоящий ID для всех ключей одного проекта. Это координация внутри группы, а не изменение квоты Google. В управляемом Live ошибки 429 также передаются серверной ротации и приостанавливают соответствующий проект.
Код приглашения даёт доступ к квоте группы. Передавайте его только своим. После смены кода организатором потребуется повторное вступление и отдельное разрешение ключей. Сам код не открывает личные ключи или историю других людей.
Сколько нужно на 15 минут
Это расчёт нагрузки, а не обещание квоты. Предполагаем непрерывный аудиопоток, 175 токенов расшифровки в минуту, предварительный перевод не чаще раза в 3,5 секунды и в среднем 4 окончательные реплики в минуту.
| Ресурс | На минуту | На 15 минут |
|---|---|---|
| Входной звук Live, 25 токенов/с | 1 500 | 22 500 |
| Текст расшифровки Live, условно | 175 | 2 625 |
| Запросы Flash Lite, округлённый расчёт | 22 | 330 |
| Вход Flash Lite, условно 500 токенов/запрос | 11 000 | 165 000 |
| Выход Flash Lite, условно 120 токенов/запрос | 2 640 | 39 600 |
Число окончательных реплик зависит от пауз. Очень короткие фразы увеличивают запросы; длинные промежуточные тексты и повторные попытки увеличивают токены. Оценка 22 запроса/мин не является жёстким верхним пределом. Учитываются системный промпт, оригинал, перевод и последние десять слов контекста каждого направления.
Ориентир по дневной квоте перевода: floor(оставшиеся RPD / 22) минут. При RPD 250 это 11 минут, при 500 это 22 минуты, при 1000 это 45 минут. Если RPM ниже 22, текущая частота обновления может упереться в ограничения раньше. Это условные примеры, не опубликованные Google квоты.
Отдельно проверяются Live-сессии, входные/выходные токены, TPM, другие приложения того же проекта и фактический остаток. Дневные квоты Google сбрасываются в полночь по тихоокеанскому времени. API приложения не видит полный баланс проекта. Честную единую цифру "минут осталось" без этих данных показывать нельзя.
Платная себестоимость без озвучки
Для текущей связки используются расценки Gemini 3.5 Transcribe Live и Gemini 3.5 Flash-Lite. Модели приложение обнаруживает по каталогу; при смене модели расчёт нужно обновить.
| Статья, 15 минут по сценарию выше | USD |
|---|---|
| Live вход: 22 500 × $3,50 / 1 млн | 0,07875 |
| Live текст: 2 625 × $21 / 1 млн | 0,055125 |
| Flash Lite вход: 165 000 × $0,30 / 1 млн | 0,0495 |
| Flash Lite выход: 39 600 × $2,50 / 1 млн | 0,099 |
| Итого | 0,282375 |
Ориентир $0,28 за 15 минут, $1,13 за час, без озвучки, повторных попыток, сервера, налогов и комиссии оплаты. Это модель нагрузки, не измеренный счёт. При более длинных репликах и частых повторах будет дороже; при редких обновлениях дешевле. Голос устройства не вызывает наш облачный TTS; обработка голоса зависит от устройства.
При подписке $4,99/120 минут и полном использовании этого сценария API составит около $2,26. При условной комиссии 3% + $0,30 остаётся около $2,28 до инфраструктуры, налогов, поддержки и привлечения. Для пакета $3,99/60 минут аналогичный остаток около $2,44. Реальные комиссии зависят от ещё не выбранного провайдера VADMAX.
Если дать каждому пользователю 15 минут ежедневно за наш счёт и он использует 30 дней полностью, только API составит около $8,47/месяц на человека. Это больше подписки $4,99. Поэтому бесплатный ежедневный пакет не следует финансировать таким тарифом без отдельного бюджета. Личный биллинговый проект переносит расходы Google на его владельца, но не делает их нулевыми.
Хранение и ограничения беты
Ключ шифруется AES-256-GCM на сервере, не записывается в localStorage, журнал или ответы API. Без аккаунта доступ привязан к защищённой HttpOnly cookie браузера. В настройках можно создать аккаунт с логином, паролем и кодом восстановления, затем явно перенести ключи этого браузера. После переноса ключи доступны на других устройствах после входа. Сохраните код восстановления в менеджере паролей; письма для восстановления пока не отправляются.
Ключ расшифровывается сервером для обращения к Google, поэтому это не сквозное шифрование. У оператора инфраструктуры есть технический доступ. Хранилище и мастер-ключ находятся вне публичной папки; резервные копии должны храниться раздельно и с ограниченными правами.
Новый Live проходит через серверный аудиопосредник с управляемым завершением соединения. Аккаунт показывает историю длительности сеансов и отдельный баланс. В текущей бете списания выключены. Личные ключи и общий пул не расходуют минуты сервиса. До денежного запуска ещё нужны подтверждённый мерчант VADMAX, подписанные платёжные события, проверка возвратов и окончательные документы продавца.
Первичные источники
- Квоты и привязка к проекту: https://ai.google.dev/gemini-api/docs/rate-limits
- Цены моделей: https://ai.google.dev/gemini-api/docs/pricing
- Условия, Use Restrictions и Paid Services: https://ai.google.dev/gemini-api/terms
- Создание и защита ключей: https://ai.google.dev/gemini-api/docs/api-key
- Бюджет не ограничивает расходы автоматически: https://cloud.google.com/billing/docs/how-to/budgets