Перейти к основному содержанию
Поверхность /v1beta/ в OrcaRouter — это прямой проброс к Gemini API от Google. Выбирайте этот путь, когда нужны возможности Gemini, которые не вписываются в формат OpenAI: встроенные данные аудио/видео, нативные встроенные инструменты вроде googleSearch, полностью оформленный generationConfig.thinkingConfig, или просто потому, что вы уже используете SDK google-genai. Для обычного чата OpenAI-совместимый путь (POST /v1/chat/completions с model=google/...) обычно проще и работает у разных провайдеров — настройку SDK см. в Совместимость / Google GenAI SDK.

​
Структура пути

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Распознаваемые действия:
ДействиеЧто делает
:generateContentЕдиничный ответ (JSON)
:streamGenerateContentSSE-поток частичных фрагментов
Другие действия Gemini (countTokens, tunedModels.* и т. д.) сегодня через эту поверхность не маршрутизируются.

​
Аутентификация

Шлюз принимает три формы заголовков на этой поверхности, поэтому официальный SDK google-genai работает без хаков с заголовками:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (query-строка, на крайний случай для инструментов, которые не поддерживают установку заголовков)

​
Примеры

curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "Write a one-sentence haiku about the sea."}]}]
  }'

​
Встроенные инструменты

Три нативных встроенных инструмента Gemini работают так, как задокументировано у Google — передавайте их в массиве tools тела запроса:
ИнструментЭффект
{"googleSearch": {}}Веб-grounding. Ответ содержит groundingMetadata. OrcaRouter фиксирует webSearchQueries для биллинга.
{"codeExecution": {}}Позволяет модели выполнять Python в песочнице.
{"urlContext": {}}Позволяет модели получать и резюмировать упомянутые URL.
Те же три инструмента доступны из Chat Completions в формате OpenAI через зарезервированные имена функций — см. Расширенные возможности / Веб-поиск и Расширенные возможности / Вызов инструментов.

​
См. также