Ключ API Gemini: получить, настроить, проверить

01Создайте ключ API OmniaKey

Войдите, откройте раздел «Ключи API» и создайте ключ для приложения. Проверьте квоту, срок действия и ограничения по моделям. Пополните баланс перед запуском запросов на генерацию.

02Задайте ключ и URL API

Выполните команды в своём терминале и замените заполнитель своим ключом. Храните ключ на сервере или в менеджере секретов. Никогда не помещайте его в код браузера или публичный репозиторий.

export OMNIAKEY_API_KEY="YOUR_OMNIAKEY_API_KEY"
export OMNIAKEY_BASE_URL="https://api.omniakey.com/v1"

03Проверьте аутентификацию

Запросите список моделей, не запуская задачу генерации. Успешный ответ — это JSON с массивом data. Так проверяется доступ по ключу; это не гарантирует, что все модели включены для вашего аккаунта.

curl --fail-with-body "$OMNIAKEY_BASE_URL/models" \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

04Используйте формат запроса модели

Выберите модель на странице семейства, скопируйте её ID API и следуйте соответствующей документации. Одна аутентификация не проверяет параметры генерации.

Ваш клиент должен поддерживать протокол выбранной модели. Проверьте документацию модели перед переключением между Chat Completions, Responses или нативным эндпоинтом поставщика.

Пример запроса на генерацию (платный)

Этот запрос использует баланс вашего аккаунта. Сначала проверьте цену выбранной модели. Пример следует документированному формату запроса; доступ к модели всё равно должен быть у вашего аккаунта.

curl --fail-with-body 'https://api.omniakey.com/v1beta/models/gemini-4-argon:generateContent' \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "contents": [
    {
      "parts": [
        {
          "text": "Explain what an API key does in one sentence."
        }
      ]
    }
  ]
}'