Zum Hauptinhalt springen
Die /v1beta/-Oberfläche von OrcaRouter ist ein direkter Passthrough zur Gemini-API von Google. Wähle diesen Pfad, wenn du Gemini-Funktionen möchtest, die nicht in die OpenAI-Form passen — inline Audio-/Video-Daten, native eingebaute Tools wie googleSearch, voll geformtes generationConfig.thinkingConfig, oder einfach weil du bereits die google-genai-SDK verwendest. Für alltäglichen Chat ist der OpenAI-kompatible Pfad (POST /v1/chat/completions mit model=google/...) in der Regel einfacher und funktioniert anbieterübergreifend — siehe Kompatibilität / Google GenAI SDK für die SDK-Einrichtung.

​
Pfad-Layout

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Erkannte Aktionen:
AktionWas sie macht
:generateContentEinmalige Antwort (JSON)
:streamGenerateContentSSE-Stream von partiellen Chunks
Andere Gemini-Aktionen (countTokens, tunedModels.*, usw.) werden heute nicht über diese Oberfläche geroutet.

​
Authentifizierung

Das Gateway akzeptiert drei Header-Formen auf dieser Oberfläche, sodass die offizielle google-genai-SDK ohne Header-Hacks funktioniert:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (Query-String, letztes Mittel für Tools, die das Setzen von Headern nicht unterstützen)

​
Beispiele

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

​
Eingebaute Tools

Die drei nativen eingebauten Tools von Gemini funktionieren wie von Google dokumentiert — übergib sie im tools-Array des Request-Body:
ToolEffekt
{"googleSearch": {}}Web-Grounding. Die Antwort enthält groundingMetadata. OrcaRouter erfasst webSearchQueries für die Abrechnung.
{"codeExecution": {}}Lässt das Modell sandboxed Python ausführen.
{"urlContext": {}}Lässt das Modell URLs abrufen und zusammenfassen, die du erwähnst.
Dieselben drei Tools sind von Chat Completions in OpenAI-Form über reservierte Funktionsnamen erreichbar — siehe Erweitert / Websuche und Erweitert / Tool-Aufrufe.

​
Siehe auch