Протокол Gemini

Отправка содержимого в формате Gemini generateContent.

Адрес сервиса

Здесь описаны нативные REST endpoint Gemini для списка моделей, генерации, streaming и эмбеддингов. Параметры изображений приведены в отдельном руководстве по нативным изображениям Gemini.

Модели и поиск

Назначение	Метод	Путь
Список моделей Gemini	GET	/v1beta/models
Совместимый список моделей Gemini	GET	/v1/models

Генерация контента

Назначение	Метод	Путь
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

Эмбеддинги

Назначение	Метод	Путь
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Совместимые эмбеддинги Gemini	POST	/v1/engines/{model}/embeddings

Минимальный запрос

Замените YOUR_MODEL на реальный ID и оставьте его в пути URL. Предпочтителен x-goog-api-key: YOUR_API_KEY; шлюз также принимает Bearer. Параметр key используйте только по требованию клиента, поскольку URL могут попадать в логи.

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "Подтвердите подключение"}]}
    ]
  }'

Проверка

Успешный ответ содержит кандидатов или эмбеддинги. Для streaming используйте streamGenerateContent, для эмбеддингов — embedContent, batchEmbedContents или совместимый путь. При 404 проверьте ID модели, путь протокола и группу Key.