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 do Gemini

Passagem direta para a API Gemini do Google. O parâmetro model_path é <model>:<action>, por exemplo google/gemini-2.5-flash:generateContent ou google/gemini-2.5-flash:streamGenerateContent.

Ações suportadas:

Ação	O que faz
`:generateContent`	Resposta única (JSON)
`:streamGenerateContent`	Stream SSE de chunks parciais

O que você pode fazer nesta superfície (o formato da requisição permanece o JSON nativo do Gemini; escolha o modelo certo para cada):

Chat / raciocínio — qualquer modelo de chat gemini-*, combinado com generationConfig.thinkingConfig para controle de orçamento.
Entrada multimodal — partes inline_data para conteúdo de imagem / áudio / vídeo / arquivo ao lado de partes text.
Function calling — tools: [{functionDeclarations: [...]}].
Ferramentas de servidor integradas — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
Texto-para-fala — modelos preview *-tts com generationConfig.responseModalities: ["AUDIO"] e speechConfig.voiceConfig.
Geração de imagem — modelos gemini-*-image*; a resposta carrega a imagem como uma parte inlineData.

A autenticação aceita o cabeçalho padrão Authorization: Bearer sk-orca-…, mais o cabeçalho ao estilo Gemini x-goog-api-key e a query string ?key= para compatibilidade com o SDK google-genai — veja Obter uma chave de 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."
        }
      ]
    }
  ]
}
'

{}

Autorizações

Authorization

string

header

obrigatório

As chaves de API do OrcaRouter têm o formato sk-orca-.... Passe-as no cabeçalho Authorization: Bearer sk-orca-....

Parâmetros de caminho

model_path

string

obrigatório

Corpo

application/json

Corpo de requisição nativo do Gemini (formato GenerateContentRequest do Google). Veja os exemplos para cargas úteis comuns.

Resposta

Resposta bem-sucedida. Para :generateContent o corpo é JSON (GenerateContentResponse). Para :streamGenerateContent o corpo é SSE (text/event-stream); cada evento é um GenerateContentResponse parcial.

GenerateContentResponse nativo do Gemini.

Cria uma mensagem