VPS для Gemini API: установка, получение API-ключа, установка, первый запуск

Gemini API это программный интерфейс Google для работы с языковыми моделями семейства Gemini.

С его помощью можно встроить возможности Gemini в своё приложение, автоматизировать задачи, строить ботов и агентов.

VPS позволяет использовать Gemini API в режиме 24/7, без привязки к домашнему компьютеру, с постоянным адресом и стабильной средой для запуска скриптов и сервисов.

Получение ключа API

API-ключ выдаётся бесплатно через Google AI Studio.

Перейдите в официальную документацию Gemini API

https://ai.google.dev/gemini-api/docs/get-started?hl=ru

Нажмите на кнопку Создать ключ API Gemini

Или создайте ключ в личном кабинете aistudio.google.com

Вас переадресует на страницу управления проектами, где вы сможете создать новый проект, создать новый ключ или скопировать существующий ключ по умолчанию.

Бесплатный уровень включает доступ к моделям Flash и Flash-Lite с ограниченной квотой. Для коммерческих проектов и снятия ограничений нужно привязать платёжный аккаунт Google Cloud.

Подключение к серверу

Если у вас уже заказан сервер, то подключитесь к нему.

ssh root@IP_СЕРВЕРА

Обновите систему:

apt update && apt upgrade -y

Установка Python и зависимостей

Установите Python и pip:

apt install python3 python3-pip python3-venv -y

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

Если есть, то зайдите в рабочую папку и активируйте виртуальное окружение

mkdir gemini-app && cd gemini-app
python3 -m venv venv
source venv/bin/activate

Установите официальный SDK Google:

pip install google-genai

Попробуйте вернуть список доступных моделей

curl "https://generativelanguage.googleapis.com/v1beta/models?key=ваш_ключ"

ваш_ключ - API ключ из aistudio.google.com

Если вернулся список моделей, то вы можете использовать этот сервер для API, если возникли ошибки, то перейдите к разделу статьи Возможные ошибки

Первый запрос к Gemini API

Сохраните API-ключ в переменную окружения:

export GEMINI_API_KEY="ваш_ключ_здесь"

Чтобы ключ сохранялся после перезагрузки, добавьте эту строку в ~/.bashrc:

echo 'export GEMINI_API_KEY="ваш_ключ_здесь"' >> ~/.bashrc
source ~/.bashrc

Создайте файл test.py:

nano test.py

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3.5-flash-lite",
    contents="Объясни в двух предложениях, что такое VPS."
)

print(response.text)

Список доступных и актуальных моделей в удобном виде можно найти в панели управления Google AI Studio

Сохраните файл

Запустите:

python3 test.py

Если всё настроено правильно, в терминале появится ответ от Gemini.

Пример: чат с историей сообщений

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

chat = client.chats.create(model="gemini-3.5-flash-lite")

while True:
    user_input = input("Вы: ")
    if user_input.lower() in ("exit", "quit"):
        break
    response = chat.send_message(user_input)
    print(f"Gemini: {response.text}")

Объект chat хранит историю диалога автоматически, не нужно передавать контекст вручную.

Запуск скрипта в фоне

Чтобы скрипт работал после закрытия SSH-сессии, используйте systemd или screen.

Вариант 1 — screen

(быстро и просто):

apt install screen -y
screen -S gemini
python3 your_script.py
# Ctrl+A, затем D — отключиться, скрипт остаётся работать
screen -r gemini  # вернуться к сессии

Вариант 2 — systemd

(для продакшена):

Создайте файл /etc/systemd/system/gemini-app.service:

[Unit]
Description=Gemini App
After=network.target

[Service]
WorkingDirectory=/root/gemini-app
ExecStart=/root/gemini-app/venv/bin/python3 test.py
Restart=always
Environment=GEMINI_API_KEY=ваш ключ #замените на ваш ключ

[Install]
WantedBy=multi-user.target

Включите и запустите:

systemctl daemon-reload
systemctl enable gemini-app
systemctl start gemini-app
systemctl status gemini-app

Теперь сервис будет запускаться автоматически при перезагрузке сервера.

Что можно установить ещё

• python-telegram-bot — если строите Telegram-бота на базе Gemini
• FastAPI — если хотите сделать собственный API-прокси
• n8n — визуальная автоматизация с нодой для HTTP-запросов к Gemini
• Cron — для запуска скриптов по расписанию

Безопасность

• Никогда не храните API-ключ в коде, только в переменных окружения или .env-файле
• Добавьте .env в .gitignore перед первым коммитом
• Периодически проверяйте квоту в Google AI Studio — вкладка Usage
• Ограничьте SSH-доступ к серверу по ключам, а не по паролю

Почему VPS подходит для Gemini API

Gemini API не требует мощного железа, вся вычислительная нагрузка лежит на Google.

На VPS все запущенные скрипты могут работать круглосуточно, ip адрес не будет меняться, что хорошо подходит для проектов, которые уже работают или для разработки и тестирования.

Для большинства проектов с Gemini API хватает минимального сервера с 1–2 ГБ RAM.

Что можно делать с Gemini API на VPS

• Запускать Telegram-ботов и веб-хуки круглосуточно
• Строить API-прокси для своих приложений
• Автоматизировать обработку текста, резюме, переводы по расписанию
• Интегрировать Gemini в n8n, Make или собственный backend
• Тестировать и разрабатывать приложения на базе LLM

Системные требования

Gemini API это облачный сервис Google. Вся нагрузка на GPU и обработка происходит на стороне Google, поэтому к серверу требования минимальные.

Задача	CPU	RAM
Скрипты и автоматизация	1 vCPU	1–2 ГБ
Telegram-бот	1 vCPU	1–2 ГБ
API-прокси или веб-сервис	1–2 vCPU	2–4 ГБ
Несколько сервисов одновременно	2 vCPU	4 ГБ

Для большинства задач достаточно минимального VPS. Нагрузка на сервер определяется не Gemini, а вашим кодом и количеством запросов.

Возможные ошибки

Ошибка "User location is not supported for the API use." Gemini

Вы можете получить ошибку User location is not supported for the API use. Это означает, что API не поддерживается в вашем регионе.

Проверим ip сервера на https://check-host.net/.

Большинством баз ip определяется правильно, но одной из баз ip определяется как Испанский.

Испания не входит в список регионов, которые поддерживают Google AI Gemini.

Поэтому попробуем поменять ip сервера на другой и отключить на нем ipv6.

Смена ip помогла, повторный вызов списка моделей вернул список без ошибок.

VPS в Нидерландах для запуска Gemini API доступны на litnets.com от 299 ₽/месяц.