Vai al contenuto principale
La superficie /v1beta/ di OrcaRouter è un passthrough diretto all’API Gemini di Google. Scegli questo path quando desideri funzionalità Gemini che non si adattano alla shape OpenAI — dati audio/video inline, strumenti nativi built-in come googleSearch, generationConfig.thinkingConfig completamente strutturato, oppure semplicemente perché sei già sull’SDK google-genai. Per la chat quotidiana il path compatibile con OpenAI (POST /v1/chat/completions con model=google/...) è di solito più semplice e funziona su tutti i provider — vedi Compatibilità / Google GenAI SDK per la configurazione dell’SDK.

​
Layout del path

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Azioni riconosciute:
AzioneCosa fa
:generateContentRisposta one-shot (JSON)
:streamGenerateContentStream SSE di chunk parziali
Altre azioni Gemini (countTokens, tunedModels.*, ecc.) oggi non sono instradate attraverso questa superficie.

​
Autenticazione

Il gateway accetta tre forme di header su questa superficie, così l’SDK ufficiale google-genai funziona senza hack sugli header:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (query string, ultima risorsa per strumenti che non supportano l’impostazione degli header)

​
Esempi

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

​
Strumenti built-in

I tre strumenti nativi built-in di Gemini funzionano come documentato da Google — passali nell’array tools del corpo della richiesta:
StrumentoEffetto
{"googleSearch": {}}Web grounding. La risposta contiene groundingMetadata. OrcaRouter cattura webSearchQueries per la fatturazione.
{"codeExecution": {}}Permette al modello di eseguire Python in sandbox.
{"urlContext": {}}Permette al modello di recuperare e riassumere URL che menzioni.
Gli stessi tre strumenti sono raggiungibili dalla shape OpenAI Chat Completions tramite nomi di funzione riservati — vedi Avanzato / Web search e Avanzato / Tool calling.

​
Vedi anche