Маршруты и авторизация
В поле 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
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 для обычного непотокового ответа. |