Gemini нативный формат

Для приложений, разработанных на основе Google GenAI SDK, 4ALL API предоставляет совместимость с нативным протоколом Gemini:

POST https://api.4allapi.com/v1beta/models/{model}:generateContent
POST https://api.4allapi.com/v1beta/models/{model}:streamGenerateContent

Пример запроса

curl "https://api.4allapi.com/v1beta/models/omni-flash:generateContent" \
  -H "Content-Type: application/json" \
  -H "x-goog-api-key: $AIPROXY_KEY" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [{"text": "用三句话介绍黑洞"}]
    }]
  }'

Ключевые моменты:

Для аутентификации используется заголовок x-goog-api-key (также поддерживается параметр запроса ?key=);
Мультимодальный ввод передаётся через массив parts, включая inline_data (base64-изображения) и т. д.;
Для потоковой передачи используется :streamGenerateContent, возвращающий инкрементальные JSON-блоки;
Параметры генерации указываются в generationConfig (temperature, maxOutputTokens и т. д.).

Что использовать: нативный протокол или OpenAI-совместимый?

Ситуация	Рекомендация
Новый проект / переключение между несколькими моделями	Используйте OpenAI-совместимый интерфейс, при смене модели меняется только `model`
Существующий код на Google SDK	Используйте нативный протокол, достаточно изменить base_url
Нужны специфичные для Gemini поля (например, настройки safety)	Используйте нативный протокол