v1beta
Gemini-совместимый API
Нативные contents, parts и generationConfig через совместимый маршрут Gemini.
Пошаговое объяснение без лишних деталей
Маршруты и авторизация
В поле Base URL укажите https://elysiumai.garden/compatible. Клиент добавит версию и операцию сам. Для ручного запроса используйте полный путь из таблицы.
Предпочтительный способ авторизации — Authorization: Bearer. Параметр ?key= тоже принимается для совместимости, но секрет в URL чаще попадает в историю и access-логи.
МетодGET
Маршрут/compatible
НазначениеИндекс API и точные маршруты
МетодGET
Маршрут/compatible/v1beta/models
НазначениеНативный список Gemini-моделей
МетодGET
Маршрут/compatible/v1/models
НазначениеСписок моделей для автоподбора в совместимых клиентах
МетодGET
Маршрут/compatible/models
НазначениеКороткий адрес того же списка
МетодPOST
Маршрут/compatible/v1beta/models/{model}:generateContent
НазначениеОбычный ответ
МетодPOST
Маршрут/compatible/v1beta/models/{model}:streamGenerateContent?alt=sse
НазначениеПотоковый ответ
generateContent
bash7 строк
1curl https://elysiumai.garden/compatible/v1beta/models/google/gemini-3.1-flash-lite:generateContent -H "Authorization: Bearer $ELYSIUM_API_KEY" -H "Content-Type: application/json" -d '{2 "contents": [{3 "role": "user",4 "parts": [{"text": "Объясни API одним предложением"}]5 }],6 "generationConfig": {"temperature": 0.4, "maxOutputTokens": 300}7 }'Структура contents и parts
Полеcontents[]
НазначениеИстория диалога с ролями user и model
Полеparts[].text
НазначениеТекстовая часть
Полеparts[].inlineData
НазначениеФайл или изображение в base64
Полеparts[].fileData
НазначениеСсылка на файл, если формат поддержан моделью
ПолеsystemInstruction
НазначениеСистемная инструкция
ПолеgenerationConfig
НазначениеТемпература, лимит выхода и другие параметры генерации
Полеtools
НазначениеНативные Gemini function declarations
Потоковая генерация
Используйте действие streamGenerateContent и alt=sse. Клиент должен читать события по мере поступления; обычный generateContent возвращает один JSON.
Термины на этой странице
Короткая расшифровка обозначений, которые встречаются в этом разделе.
ТерминBase URL
Что означаетБазовый адрес API, к которому клиент добавляет нужный маршрут.
ТерминAPI-ключ
Что означаетСекрет для авторизации и списания запросов с вашего баланса.
ТерминModel ID
Что означаетТочное системное имя модели из каталога Elysium AI.
Терминcontents
Что означаетИстория сообщений в нативном формате Gemini.
Терминparts
Что означаетТекстовые, файловые и другие части одного сообщения.
ТерминgenerationConfig
Что означаетПараметры генерации Gemini: температура, лимит выхода и другие настройки.
ТерминgenerateContent
Что означаетОперация Gemini для обычного непотокового ответа.