VDS для Gemini API

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

VDS в этой схеме нужен как сервер для вашего приложения. Он принимает запрос пользователя, отправляет его в Gemini API и возвращает полученный ответ.

Для большинства таких задач достаточно обычного VDS без видеокарты.

2. Какой VDS выбрать

Для приложения, которое только отправляет запросы в Gemini API, требования к серверу обычно невысокие. Вам не нужна видеокарта и не требуется устанавливать большую языковую модель на диск.

Для небольшого проекта можно начать с конфигурации:

• 1–2 CPU;
• 1–2 ГБ RAM;
• 10–20 ГБ SSD;
• Ubuntu 24.04 LTS;

3. Подготовка Ubuntu

Если сервер используется не только для тестов, создайте отдельного пользователя:

adduser geminiCopy

Добавьте его в группу sudo:

usermod -aG sudo geminiCopy

После этого можно продолжать работу от отдельного пользователя:

su - geminiCopy

Для небольшого теста этот шаг можно пропустить и использовать существующего пользователя.

4. Создание API-ключа Gemini

Для обращения к Gemini API необходим API-ключ. Google предоставляет управление ключами через Google AI Studio.

Создайте ключ в разделе API Keys и сохраните его в безопасном месте: https://ai.google.dev/gemini-api/docs

Не вставляйте настоящий ключ непосредственно в исходный код.

Для создания API ключа потребуется зайти на сайт с ip страны, в которой поддерживается API

5. Настройка API-ключа на VDS

Создайте переменную окружения:

export GEMINI_API_KEY="ваш_ключ"Copy

Проверьте, что она установлена:

echo $GEMINI_API_KEYCopy

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

Однако хранить секрет таким способом удобно только для текущей сессии. После выхода из SSH переменная исчезнет.

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

nano /etc/gemini.envCopy

Добавьте:

GEMINI_API_KEY=ВАШ_API_КЛЮЧCopy

Ограничьте доступ к файлу:

chmod 600 /etc/gemini.envCopy

Теперь прочитать его сможет только root.

6. Установка Python

Если приложение будет написано на Python, установите Python и необходимые инструменты:

apt install python3 python3-pip python3-venv -yCopy

Создайте каталог приложения:

mkdir -p ~/gemini-app
cd ~/gemini-appCopy

Создайте виртуальное окружение:

python3 -m venv venvCopy

Активируйте его:

source venv/bin/activateCopy

Теперь установите официальный пакет Google для работы с Gemini:

pip install -U google-genaiCopy

Официальная документация Gemini использует пакет google-genai для Python.

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

Перед написанием полноценного приложения можно проверить сам API отдельно.

Установите ключ:

export GEMINI_API_KEY="ВАШ_API_КЛЮЧ"Copy

Теперь выполните тестовый запрос:

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Привет. Проверка работы"
          }
        ]
      }
    ]
  }'Copy

Если всё настроено правильно, в ответе вы получите JSON с результатом генерации.

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

Доступные модели можно посмотреть по ссылке https://aistudio.google.com/docs/models

8. Подключение Gemini API через Python

Создайте файл приложения:

nano app.pyCopy

Добавьте простой пример:

from google import genai

client = genai.Client()

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

response = chat.send_message(
    message="Привет! Проверка связи."
)

print(response.text)Copy

Запустите его:

python3 app.pyCopy

Если программа выводит ответ модели, основная часть настройки завершена.

На этом этапе VDS уже работает с Gemini API.

12. Что делать при ошибках

401 или ошибка авторизации

Проверьте API-ключ:

echo $GEMINI_API_KEYCopy

Если переменная пустая, приложение не получило ключ.

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

400 User locaton is not supportes for API use

Есть список стран, для которых доступно использование API, если ip адрес сервера или аккаунт принадлежит другой стране, то может возникнуть ошибка User locaton is not supportes for API use. Попробуйте поменять ip сервера или использовать другой Google аккаунт

Ошибка превышения лимита

Gemini API ограничивает количество запросов и объём обрабатываемых токенов. Ограничения обычно учитываются по RPM, TPM и RPD, причём лимиты применяются на уровне проекта, а не отдельного API-ключа.

Если приложение отправляет много запросов одновременно, то происходит ограничение на стороне API.

В таком случае проверьте текущие лимиты проекта и добавьте обработку ошибок и повторных запросов с задержкой.