Passer au contenu principal
La surface /v1beta/ d’OrcaRouter est un pass-through direct vers l’API Gemini de Google. Choisissez ce chemin quand vous voulez des fonctionnalités Gemini qui ne tiennent pas dans la forme OpenAI — données audio/vidéo en ligne, outils natifs intégrés comme googleSearch, generationConfig.thinkingConfig complet, ou simplement parce que vous êtes déjà sur le SDK google-genai. Pour le chat quotidien, le chemin compatible OpenAI (POST /v1/chat/completions avec model=google/...) est généralement plus simple et fonctionne entre fournisseurs — voir Compatibilité / SDK Google GenAI pour la configuration du SDK.

​
Disposition du chemin

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Actions reconnues :
ActionCe qu’elle fait
:generateContentRéponse unique (JSON)
:streamGenerateContentFlux SSE de morceaux partiels
Les autres actions Gemini (countTokens, tunedModels.*, etc.) ne sont pas routées par cette surface aujourd’hui.

​
Authentification

La passerelle accepte trois formes d’en-tête sur cette surface, donc le SDK officiel google-genai fonctionne sans hacks d’en-tête :
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (chaîne de requête, dernier recours pour les outils qui ne prennent pas en charge la définition d’en-têtes)

​
Exemples

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

​
Outils intégrés

Les trois outils intégrés natifs de Gemini fonctionnent comme documentés par Google — passez-les dans le tableau tools du corps de requête :
OutilEffet
{"googleSearch": {}}Ancrage web. La réponse porte groundingMetadata. OrcaRouter capture webSearchQueries pour la facturation.
{"codeExecution": {}}Permet au modèle d’exécuter Python en bac à sable.
{"urlContext": {}}Permet au modèle de récupérer et résumer les URL que vous mentionnez.
Les trois mêmes outils sont accessibles depuis Chat Completions de forme OpenAI via des noms de fonction réservés — voir Avancé / Recherche web et Avancé / Appel d’outils.

​
Voir aussi