Google Gemini API: налаштування та використання на VPS

Google Gemini API: налаштування та використання

Google Gemini — потужна мультимодальна AI-модель від Google DeepMind. Gemini 1.5 Pro підтримує контекстне вікно до 1 мільйона токенів — більше, ніж будь-який інший комерційний API. Gemini 1.5 Flash — швидкий і безкоштовний для невеликих обсягів.

Отримання API ключа

Перейдіть на aistudio.google.com, створіть проєкт і отримайте API ключ. Безкоштовний тариф: 15 RPM (запитів/хв) і 1 500 000 токенів/день для Gemini 1.5 Flash.

Перший запит

pip install google-generativeai

import google.generativeai as genai
import os

genai.configure(api_key=os.environ["GEMINI_API_KEY"])
model = genai.GenerativeModel("gemini-1.5-flash")

response = model.generate_content("Поясни принцип роботи VPS хостингу в 3 реченнях.")
print(response.text)

Багатоходовий чат

chat = model.start_chat(history=[])

response1 = chat.send_message("Я налаштовую nginx на Ubuntu.")
print(response1.text)

response2 = chat.send_message("Як додати SSL сертифікат?")
print(response2.text)  # пам'ятає контекст попередніх повідомлень

Аналіз зображень (Vision)

import google.generativeai as genai
from PIL import Image

model = genai.GenerativeModel("gemini-1.5-flash")
image = Image.open("server-screenshot.png")

response = model.generate_content([
    "Опиши, що зображено, і знайди можливі проблеми:",
    image
])
print(response.text)

Інтеграція з PHP (через REST API)

<?php
function askGemini(string $prompt): string {
    $apiKey = $_ENV['GEMINI_API_KEY'];
    $url = "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key={$apiKey}";
    $data = [
        'contents' => [['parts' => [['text' => $prompt]]]]
    ];
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER     => ['Content-Type: application/json'],
        CURLOPT_POSTFIELDS     => json_encode($data),
    ]);
    $r = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $r['candidates'][0]['content']['parts'][0]['text'] ?? '';
}
echo askGemini('Напиши короткий опис для сторінки хостингу');

Ціни Gemini (2025)

Часті помилки

Помилки Gemini API зазвичай вказують на конкретну і легко усувну причину, якщо не ігнорувати текст поля message у відповіді.

400 — API key not valid. Please pass a valid API key

Ключ скопійовано з опискою, відкликано в aistudio.google.com або використовується не в тому проєкті Google Cloud, до якого прив'язаний. Перестворіть ключ і переконайтеся, що змінна оточення читається без зайвих пробілів і переносів рядка.

429 — Resource has been exhausted (e.g. check quota)

Перевищено ліміт запитів за хвилину або добову квоту токенів для обраної моделі. На відміну від тимчасового перевантаження сервера, ця помилка не мине сама собою за кілька секунд — потрібно або знизити частоту запитів, або перейти на платний тариф із вищими лімітами.

Безкоштовний і платний тариф: на що дивитися

Коли Gemini API не підходить

• Критична приватність даних, і їх не можна передавати за межі власної інфраструктури — тоді потрібен локальний варіант на кшталт Ollama.
• Продукт уже зав'язаний на екосистему OpenAI (асистенти, інструменти, формат function calling) — міграція формату запитів і відповідей потребує окремого шару сумісності.
• Потрібна стабільна ціна без сюрпризів при зростанні навантаження — безкоштовний тариф Gemini розрахований на невеликі обсяги і не годиться як основа продакшен-сервісу.
• Потрібна гарантована затримка відповіді — як і в інших хмарних API, під час пікового навантаження провайдера час відповіді не гарантований.

Перевірка, що ключ і запити працюють

curl -s "https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY" | head -c 200

Успішна відповідь — це JSON зі списком доступних моделей. Якщо повертається помилка 400 з текстом про недійсний ключ, проблема на рівні самого ключа, і розбиратися з логікою чату чи аналізу зображень ще зарано.

Часті питання

Чи потрібно купувати ключ для Gemini API, чи його видають безкоштовно?

Ключ для Gemini API не купують окремо — його створюють безкоштовно у Google AI Studio одразу після реєстрації проєкту, а платним стає не сама видача ключа, а обсяг запитів понад безкоштовні ліміти. Власник облікового запису Google отримує доступ миттєво, без звернення до підтримки і без попередньої угоди на покупку ліцензії.

Чи годиться безкоштовний тариф Gemini для робочого проєкту з реальним трафіком?

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

Чи використовує Google дані із запитів до Gemini API для навчання власних моделей?

Використання даних для навчання моделей описане в умовах сервісу і залежить від обраного тарифу, а не є одним фіксованим правилом для всіх. У безкоштовному тарифі дані запитів здатні потрапляти у навчання, платний же план таке зазвичай виключає. Перед надсиланням чутливої інформації варто звірити актуальні умови саме підключеної версії API.

Яку модель Gemini обрати для проєкту — Flash чи Pro?

Flash — швидка і економна модель для типових завдань на кшталт чат-ботів, коротких відповідей і простого аналізу зображень, а Pro краще впорається зі складними міркуваннями і дуже довгим контекстом діалогу. Для більшості проєктів на хостингу розумно починати з Flash і переходити на Pro лише тоді, коли якість відповідей виявиться явно недостатньою для задачі.