Нативная генерация Gemini
Прямой проброс к Gemini API от Google. Параметр model_path
имеет вид <model>:<action>, например
google/gemini-2.5-flash:generateContent или
google/gemini-2.5-flash:streamGenerateContent.
Поддерживаемые действия:
| Действие | Что делает |
|---|---|
:generateContent | Одноразовый ответ (JSON) |
:streamGenerateContent | SSE-поток частичных фрагментов |
Что можно делать на этой поверхности (форма запроса остаётся нативным JSON Gemini; выбирайте подходящую модель для каждого случая):
- Чат / рассуждения — любая
gemini-*чат-модель, в паре сgenerationConfig.thinkingConfigдля контроля бюджета. - Мультимодальный ввод —
inline_dataчасти для изображения / аудио / видео / файла рядом сtextчастями. - Вызов функций —
tools: [{functionDeclarations: [...]}]. - Встроенные серверные инструменты —
tools: [{googleSearch: {}}],tools: [{codeExecution: {}}],tools: [{urlContext: {}}]. - Синтез речи — превью-модели
*-ttsсgenerationConfig.responseModalities: ["AUDIO"]иspeechConfig.voiceConfig. - Генерация изображений — модели
gemini-*-image*; ответ содержит изображение как частьinlineData.
Аутентификация принимает стандартный заголовок
Authorization: Bearer sk-orca-…, а также Gemini-стиль
заголовка x-goog-api-key и query-строку ?key= для
совместимости с google-genai SDK — см.
Получить API-ключ.
Авторизации
API-ключи OrcaRouter выглядят как sk-orca-.... Передавайте их в заголовке Authorization: Bearer sk-orca-....
Параметры пути
Тело
Тело запроса в нативном формате Gemini (форма
GenerateContentRequest от Google). См. примеры
типичных полезных нагрузок.
Ответ
Успешный ответ. Для :generateContent тело — это JSON
(GenerateContentResponse). Для :streamGenerateContent
тело — это SSE (text/event-stream); каждое событие —
это частичный GenerateContentResponse.
Нативный GenerateContentResponse от Gemini.
