Parámetros de Ruta
Nombre del modelo (por ejemplo,
gemini-2.5-pro, gemini-2.5-flash).Parámetros de Consulta
Clave API (alternativa a la autenticación por encabezado).
Autenticación
Los endpoints de Gemini admiten múltiples métodos de autenticación:- Parámetro de consulta
?key=YOUR_API_KEY - Encabezado
x-goog-api-key: YOUR_API_KEY - Encabezado
Authorization: Bearer YOUR_API_KEY
Cuerpo de la Solicitud
Contenidos de la conversación.Cada objeto de contenido contiene:
role(string):useromodelparts(array): Partes del contenido (texto o datos en línea)
Instrucción del sistema para el modelo.
Configuración de generación:
temperature(number): Temperatura de muestreotopP(number): Probabilidad de muestreo de núcleo (nucleus sampling)topK(integer): Muestreo Top-KmaxOutputTokens(integer): Máximo de tokens de salidastopSequences(array): Secuencias de parada
Configuración de filtros de seguridad.
Respuesta
Candidatos de contenido generado.
Información de uso de tokens.
Vision Input Example
For Gemini vision requests, place images insidecontents[].parts[] as structured inline_data parts. The data field should contain Base64-encoded file bytes, and mime_type should match the uploaded image format.