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 Gemini

Paso directo a la API Gemini de Google. El parámetro model_path es <model>:<action>, por ejemplo google/gemini-2.5-flash:generateContent o google/gemini-2.5-flash:streamGenerateContent.

Acciones soportadas:

Acción	Lo que hace
`:generateContent`	Respuesta única (JSON)
`:streamGenerateContent`	Flujo SSE de fragmentos parciales

Lo que puedes hacer en esta superficie (la forma de la solicitud sigue siendo JSON nativo de Gemini; elige el modelo adecuado para cada uno):

Chat / razonamiento — cualquier modelo chat gemini-*, emparejado con generationConfig.thinkingConfig para control de presupuesto.
Entrada multimodal — partes inline_data para contenido imagen / audio / vídeo / archivo junto con partes text.
Llamada a función — tools: [{functionDeclarations: [...]}].
Herramientas integradas del servidor — tools: [{googleSearch: {}}], tools: [{codeExecution: {}}], tools: [{urlContext: {}}].
Texto a voz — modelos preview *-tts con generationConfig.responseModalities: ["AUDIO"] y speechConfig.voiceConfig.
Generación de imagen — modelos gemini-*-image*; la respuesta lleva la imagen como parte inlineData.

La autenticación acepta la cabecera estándar Authorization: Bearer sk-orca-…, más la cabecera estilo Gemini x-goog-api-key y la cadena de consulta ?key= para compatibilidad con el SDK google-genai — ver Obtener una clave 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."
        }
      ]
    }
  ]
}
'

{}

Autorizaciones

Authorization

string

header

requerido

Las claves API de OrcaRouter se ven como sk-orca-.... Pásalas en la cabecera Authorization: Bearer sk-orca-....

Parámetros de ruta

model_path

string

requerido

Cuerpo

application/json

Cuerpo de solicitud nativo Gemini (forma GenerateContentRequest de Google). Ver los ejemplos para cargas útiles comunes.

Respuesta

Respuesta exitosa. Para :generateContent el cuerpo es JSON (GenerateContentResponse). Para :streamGenerateContent el cuerpo es SSE (text/event-stream); cada evento es una GenerateContentResponse parcial.

GenerateContentResponse nativo Gemini.

Crear un mensaje