API-ключ Google AI Studio (Gemini)
Google AI Studio даёт доступ к моделям Gemini — Style Rewriter использует их для генерации изображений и текстовых задач. Большой плюс этого провайдера — бесплатный тариф, поэтому это самый простой способ начать работу с Style Rewriter без привязки карты.
Весь процесс занимает 2–5 минут (если у вас уже есть Google-аккаунт). Интерфейс aistudio.google.com на английском — все литеральные надписи в инструкции даны в таком виде.
Регистрация
Отдельной регистрации в Google AI Studio нет — всё работает на обычном Google-аккаунте. Если у вас уже есть Gmail или любой Google-сервис — этот шаг можно пропустить.
- Откройте https://aistudio.google.com/.
- Нажмите
Sign inв правом верхнем углу. - Войдите со своим Google-аккаунтом или создайте новый по ссылке
Create account. - На первом экране AI Studio попросит принять условия использования (
Terms of Service) и подтвердить, что вам 18+. НажмитеI agree.
Google AI Studio недоступен в некоторых регионах (включая ряд стран ЕС в первое время после запуска новых моделей). Если страница AI Studio открывается, но кнопка создания ключа disabled либо API возвращает ошибку про регион — подключите VPN с американским exit-узлом и попробуйте снова. Список поддерживаемых стран — на странице available-regions.
Биллинг и оплата
В отличие от Anthropic / OpenAI / BFL, у Gemini есть бесплатный тариф: API можно вызывать без привязки карты. Лимиты на бесплатном тарифе ниже (в запросах в минуту и в день), но для пробного использования и для команды редакторов на средний поток текстов их обычно хватает.
- Бесплатный тариф (по умолчанию): ничего делать не нужно. Сразу после создания ключа (следующий шаг) он работает на free tier с лимитами на RPM (запросы/минуту), TPM (токены/минуту) и RPD (запросы/день). Конкретные числа — на странице лимитов; они зависят от модели и со временем меняются.
- Платный тариф (опционально): если упираетесь в лимиты free tier, можно перейти на paid tier через Google Cloud. Откройте https://aistudio.google.com/apikey, рядом с вашим проектом нажмите
Set up Billing. Это перебросит на Google Cloud Console, где нужно создать billing account и привязать карту. После этого тот же API-ключ будет работать с paid-тарифными лимитами.
Если переходите на paid tier — Google Cloud принимает международные карты, но российские карты (выпущенные в РФ) не работают. Нужна иностранная карта. На free tier карта вообще не нужна.
Создание API-ключа
В отличие от других провайдеров, у Gemini ключ показывается не один раз, а постоянно — его можно посмотреть в любой момент через AI Studio. Это удобно, но требует аккуратности (не давайте ссылку на дашборд кому попало).
- Откройте https://aistudio.google.com/apikey.
- Нажмите
Create API key. - В диалоге выберите Google Cloud-проект. Если вы здесь впервые — AI Studio предложит
Create API key in new project(создать новый проект автоматически). Нажмите её, ничего настраивать не нужно. - Дождитесь генерации ключа (1–2 секунды).
- Скопируйте показанный ключ. Он начинается с
AIzaи дальше идёт строка ~37 символов из букв и цифр (напримерAIzaSyA...).
Если потом нужно посмотреть ключ ещё раз — снова откройте aistudio.google.com/apikey, найдите ключ в списке и кликните по нему. Полная строка снова появится в модалке. Это отличие Gemini от Anthropic / OpenAI / BFL, где ключ показывается строго один раз.
Вставка в Style Rewriter
- В Style Rewriter войдите как админ.
- Откройте вкладку
⚙️ Настройкив шапке. - Внутри настроек выберите подвкладку
🔑 API-ключи. - Найдите карточку
Google AI Studio (Gemini). - Вставьте скопированный ключ в поле ввода (placeholder подсказывает формат
AIza...). - Нажмите
Сохранить. - Нажмите
Тест ключа— кнопка отправит на бэк маленький probe-запрос к Gemini (несколько токенов, на free tier бесплатно) и проверит, что ключ работает. - Дождитесь зелёного бейджа «✓ Активен» рядом с карточкой. Если бейдж красный — см. следующий раздел.
После активации ключа модели Gemini появятся в выпадающем списке моделей на основном экране.
Что делать если ключ не работает
Ниже типичные ошибки от Gemini и что они значат. Полный список — в документации Gemini API по ошибкам.
API_KEY_INVALID(HTTP 400) — ключ невалидный, удалён или вставлен с пробелами/обрывом. Проверьте, что вставили полную строку (включая префиксAIza) без пробелов в начале/конце. Если проблема осталась — пересоздайте ключ наaistudio.google.com/apikey.PERMISSION_DENIED(HTTP 403) — у ключа нет доступа к запрошенной модели или Gemini API не включён в Google Cloud-проекте, к которому привязан ключ. Откройте AI Studio → APIs (или Cloud Console → API Library) и убедитесь, чтоGenerative Language APIв проекте enabled.RESOURCE_EXHAUSTED(HTTP 429) — превышен лимит free tier (RPM / TPM / RPD). Подождите минуту (для RPM/TPM), сутки (для RPD) либо переходите на paid tier через биллинг.INVALID_ARGUMENT(HTTP 400) — параметры запроса неверные (обычно проблема не в ключе, а в формате запроса). Если возникает на «Тест ключа» — это баг Style Rewriter, напишите в поддержку.UNAVAILABLE(HTTP 503) — Gemini временно перегружен либо модель временно недоступна. Это не про вас лично — подождите пару минут и повторите.- Region / location error — ваш регион (или регион вашего бэка) не в списке supported. Подключите VPN с американским exit-узлом, если запускаете локально. Прод Style Rewriter крутится в Latvia — этого региона хватает.
Если Style Rewriter возвращает ошибку с непонятным текстом — откройте DevTools браузера (F12) → вкладкаNetwork→ найдите запрос на/api/keys/google/test→ посмотрите Response. Там будет точный код ошибки от Gemini, который проще нагуглить.