curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

Gemini Native

Gemini natif generate

Pass-through direct vers l’API Gemini de Google. Le paramètre model_path est <model>:<action>, par exemple google/gemini-2.5-flash:generateContent ou google/gemini-2.5-flash:streamGenerateContent.

Actions prises en charge :

Action	Ce qu’elle fait
`:generateContent`	Réponse unique (JSON)
`:streamGenerateContent`	Flux SSE de morceaux partiels

Ce que vous pouvez faire sur cette surface (la forme de requête reste le JSON natif de Gemini ; choisissez le bon modèle pour chacun) :

Chat / raisonnement — tout modèle chat gemini-*, associé avec generationConfig.thinkingConfig pour le contrôle du budget.
Entrée multimodale — parties inline_data pour le contenu image / audio / vidéo / fichier aux côtés des parties text.
Appel de fonction — tools: [{functionDeclarations: [...]}].
Outils serveur intégrés — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
Synthèse vocale — modèles preview *-tts avec generationConfig.responseModalities: ["AUDIO"] et speechConfig.voiceConfig.
Génération d’image — modèles gemini-*-image* ; la réponse porte l’image comme partie inlineData.

L’authentification accepte l’en-tête standard Authorization: Bearer sk-orca-…, plus l’en-tête style Gemini x-goog-api-key et la chaîne de requête ?key= pour la compatibilité avec le SDK google-genai — voir Obtenir une clé API.

POST

v1beta

models

{model_path}

curl --request POST \
  --url https://api.orcarouter.ai/v1beta/models/{model_path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Write a one-sentence haiku about the sea."
        }
      ]
    }
  ]
}
'

{}

Autorisations

Authorization

string

header

requis

Les clés API OrcaRouter ressemblent à sk-orca-.... Passez-les dans l'en-tête Authorization: Bearer sk-orca-....

Paramètres de chemin

model_path

string

requis

Corps

application/json

Corps de requête natif Gemini (forme GenerateContentRequest de Google). Voir les exemples pour les charges utiles courantes.

Réponse

Réponse réussie. Pour :generateContent, le corps est du JSON (GenerateContentResponse). Pour :streamGenerateContent, le corps est SSE (text/event-stream) ; chaque événement est une GenerateContentResponse partielle.

GenerateContentResponse natif Gemini.

Créer un message