Saltar para o conteúdo principal
A superfície /v1beta/ do OrcaRouter é uma passagem direta para a API Gemini do Google. Escolha este caminho quando quiser recursos do Gemini que não cabem no formato OpenAI — dados inline de áudio/vídeo, ferramentas nativas integradas como googleSearch, generationConfig.thinkingConfig totalmente formado, ou simplesmente porque você já está no SDK google-genai. Para chat do dia a dia, o caminho compatível com OpenAI (POST /v1/chat/completions com model=google/...) geralmente é mais simples e funciona entre provedores — veja Compatibilidade / SDK Google GenAI para configuração do SDK.

​
Layout do caminho

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Ações reconhecidas:
AçãoO que faz
:generateContentResposta única (JSON)
:streamGenerateContentStream SSE de chunks parciais
Outras ações do Gemini (countTokens, tunedModels.*, etc.) não são roteadas por esta superfície hoje.

​
Autenticação

O gateway aceita três formatos de cabeçalho nesta superfície, então o SDK oficial google-genai funciona sem hacks de cabeçalho:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (query string, último recurso para ferramentas que não suportam definição de cabeçalhos)

​
Exemplos

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

​
Ferramentas integradas

As três ferramentas nativas integradas do Gemini funcionam como documentadas pelo Google — passe-as no array tools do corpo da requisição:
FerramentaEfeito
{"googleSearch": {}}Grounding web. A resposta carrega groundingMetadata. O OrcaRouter captura webSearchQueries para faturamento.
{"codeExecution": {}}Permite ao modelo executar Python em sandbox.
{"urlContext": {}}Permite ao modelo buscar e resumir URLs que você mencionar.
As mesmas três ferramentas são acessíveis a partir de Chat Completions no formato OpenAI via nomes de função reservados — veja Avançado / Busca web e Avançado / Chamada de ferramentas.

​
Veja também