Saltar al contenido principal
La superficie /v1beta/ de OrcaRouter es un paso directo a la API Gemini de Google. Elige este camino cuando quieras funciones de Gemini que no encajan en la forma OpenAI — datos de audio/vídeo en línea, herramientas integradas nativas como googleSearch, generationConfig.thinkingConfig completamente formado, o simplemente porque ya estás en el SDK google-genai. Para chat diario, el camino compatible con OpenAI (POST /v1/chat/completions con model=google/...) suele ser más simple y funciona entre proveedores — consulta Compatibilidad / SDK de Google GenAI para la configuración del SDK.

​
Diseño del camino

POST https://api.orcarouter.ai/v1beta/models/{model}:{action}
Acciones reconocidas:
AcciónLo que hace
:generateContentRespuesta única (JSON)
:streamGenerateContentFlujo SSE de fragmentos parciales
Otras acciones Gemini (countTokens, tunedModels.*, etc.) no se enrutan por esta superficie hoy.

​
Autenticación

La pasarela acepta tres formas de cabecera en esta superficie, de modo que el SDK oficial google-genai funciona sin hacks de cabecera:
  • Authorization: Bearer sk-orca-...
  • x-goog-api-key: sk-orca-...
  • ?key=sk-orca-... (cadena de consulta, último recurso para herramientas que no permiten configurar cabeceras)

​
Ejemplos

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

​
Herramientas integradas

Las tres herramientas integradas nativas de Gemini funcionan como documenta Google — pásalas en la matriz tools del cuerpo de la solicitud:
HerramientaEfecto
{"googleSearch": {}}Anclaje web. La respuesta lleva groundingMetadata. OrcaRouter captura webSearchQueries para facturación.
{"codeExecution": {}}Permite al modelo ejecutar Python en sandbox.
{"urlContext": {}}Permite al modelo obtener y resumir las URL que menciones.
Las mismas tres herramientas son accesibles desde Chat Completions en forma OpenAI vía nombres de función reservados — consulta Avanzado / Búsqueda web y Avanzado / Llamadas a herramientas.

​
Véase también