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

Generate nativo di Gemini

Passthrough diretto all’API Gemini di Google. Il parametro model_path è <model>:<action>, ad esempio google/gemini-2.5-flash:generateContent o google/gemini-2.5-flash:streamGenerateContent.

Azioni supportate:

Azione	Cosa fa
`:generateContent`	Risposta one-shot (JSON)
`:streamGenerateContent`	Stream SSE di chunk parziali

Cosa puoi fare su questa superficie (la forma della richiesta resta il JSON nativo di Gemini; scegli il modello giusto per ciascuno):

Chat / reasoning — qualsiasi modello chat gemini-*, accoppiato con generationConfig.thinkingConfig per il controllo del budget.
Input multimodale — parti inline_data per contenuto image / audio / video / file accanto alle parti text.
Function calling — tools: [{functionDeclarations: [...]}].
Tool server integrati — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
Text-to-speech — modelli preview *-tts con generationConfig.responseModalities: ["AUDIO"] e speechConfig.voiceConfig.
Generazione di immagini — modelli gemini-*-image*; la risposta trasporta l’immagine come parte inlineData.

L’autenticazione accetta l’header standard Authorization: Bearer sk-orca-…, oltre all’header x-goog-api-key stile Gemini e alla query string ?key= per compatibilità con l’SDK google-genai — vedi Ottieni una chiave 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."
        }
      ]
    }
  ]
}
'

{}

Autorizzazioni

Authorization

string

header

obbligatorio

Le chiavi API di OrcaRouter hanno la forma sk-orca-.... Passale nell'header Authorization: Bearer sk-orca-....

Parametri del percorso

model_path

string

obbligatorio

Corpo

application/json

Request body nativo di Gemini (forma GenerateContentRequest di Google). Vedi gli esempi per i payload comuni.

Risposta

Risposta riuscita. Per :generateContent il body è JSON (GenerateContentResponse). Per :streamGenerateContent il body è SSE (text/event-stream); ogni evento è un GenerateContentResponse parziale.

GenerateContentResponse nativo di Gemini.

Crea un messaggio