Skip to main content
TokenLab expone esta ruta solo para modelos que anuncian un contrato Gemini nativo y tienen una ruta upstream del mismo protocolo; no hay fallback a Chat Completions. Los nombres ProtoJSON en lowerCamelCase y los nombres proto originales en snake_case son oficiales y se conservan incluso en solicitudes mixtas. Los campos desconocidos se reenvían con el mejor esfuerzo y el upstream decide si los admite.

Parámetros de Ruta

string
requerido
Nombre del modelo (por ejemplo, gemini-2.5-pro, gemini-3.5-flash).

Parámetros de Consulta

string
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

array
requerido
Contenido de la conversación. Los valores de role y todos los parts se conservan tal como se enviaron; TokenLab no aplica trim/lowercase, reescritura Base64 ni inferencia MIME. inlineData / inline_data y fileData / file_data son grafías oficiales, y TokenLab no exige localmente fileData.mimeType. Las IDs de Files o Cache creadas por TokenLab se someten a comprobación de propiedad y mantienen su vínculo upstream; el proveedor decide las demás reglas de medios y herramientas.
object
Instrucción del sistema para el modelo.
object
Configuración nativa de generación. Se aceptan sin cambios nombres lowerCamelCase como maxOutputTokens, candidateCount y thinkingConfig, así como sus equivalentes snake_case. TokenLab no elimina thinkingConfig después de un fallo ni impone un límite local de candidateCount para streaming; el upstream decide los rangos y combinaciones.
array
Configuración de filtros de seguridad.

Respuesta

array
Candidatos de contenido generado.
object
Información de uso de tokens.

Ejemplos de entrada multimodal

Para solicitudes multimodales de Gemini, coloca los medios dentro de contents[].parts[] usando bytes inline o referencias de archivo basadas en URL. Categorías multimedia compatibles actualmente en los detalles del modelo de Gemini:
  • imagen
  • audio
  • video
Para medios inline, usa inlineData o inline_data y pasa los bytes del archivo codificados en Base64. Para medios mediante URL, usa fileData o file_data y pasa una URL pública https.

Ejemplo de entrada de imagen

Ejemplo de entrada de audio

Ejemplo de entrada de video

Ejemplo de entrada de video

Ejemplo de entrada de audio