Przejdź do głównej treści
Powierzchnia /v1beta/ OrcaRouter to bezpośredni passthrough do API Gemini od Google. Wybierz tę ścieżkę, gdy chcesz funkcji Gemini, które nie mieszczą się w kształcie OpenAI — inline dane audio/wideo, natywne wbudowane narzędzia jak googleSearch, w pełni rozwinięty generationConfig.thinkingConfig, albo po prostu dlatego, że już używasz SDK google-genai. Dla codziennego chatu ścieżka zgodna z OpenAI (POST /v1/chat/completions z model=google/...) jest zwykle prostsza i działa między dostawcami — zobacz Kompatybilność / Google GenAI SDK, aby skonfigurować SDK.

​
Układ ścieżki

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Rozpoznawane akcje:
AkcjaCo robi
:generateContentJednorazowa odpowiedź (JSON)
:streamGenerateContentStrumień SSE częściowych fragmentów
Inne akcje Gemini (countTokens, tunedModels.* itd.) nie są obecnie routowane przez tę powierzchnię.

​
Uwierzytelnianie

Brama akceptuje na tej powierzchni trzy formy nagłówków, więc oficjalny SDK google-genai działa bez modyfikowania nagłówków:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (query string, ostateczność dla narzędzi, które nie obsługują ustawiania nagłówków)

​
Przykłady

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."}]}]
  }'

​
Wbudowane narzędzia

Trzy natywne wbudowane narzędzia Gemini działają tak, jak udokumentował Google — przekaż je w tablicy tools w ciele żądania:
NarzędzieEfekt
{"googleSearch": {}}Web grounding. Odpowiedź zawiera groundingMetadata. OrcaRouter rejestruje webSearchQueries do rozliczeń.
{"codeExecution": {}}Pozwala modelowi uruchomić Python w sandboxie.
{"urlContext": {}}Pozwala modelowi pobrać i podsumować URL-e, o których wspomnisz.
Te same trzy narzędzia są dostępne z Chat Completions w kształcie OpenAI przez zarezerwowane nazwy funkcji — zobacz Zaawansowane / Web search i Zaawansowane / Tool calling.

​
Zobacz także