Gemini nativo
Generar contenido
Genera contenido usando el formato de la API de Google Gemini
Utilice los formatos de solicitud y respuesta de Gemini con un modelo devuelto por Listar modelos. Se aceptan nombres de campo en lowerCamelCase de ProtoJSON y los correspondientes en snake_case de proto. Los campos y valores opcionales admitidos dependen del modelo seleccionado.
Parámetros de ruta
Nombre del modelo (p. ej., gemini-2.5-pro, gemini-3.5-flash).
Parámetros de consulta
API key (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
Contenido de la conversación con parts y un role opcional. Las partes multimedia utilizan inlineData / inline_data o fileData / file_data. Los archivos y los ID de caché creados por TokenLab solo se pueden usar en su Workspace propietario.
Instrucción del sistema para el modelo.
Ajustes de generación como temperature, topP, topK, maxOutputTokens, stopSequences, candidateCount, responseModalities, responseMimeType, responseSchema y thinkingConfig. También se aceptan los nombres correspondientes en snake_case. Los valores y combinaciones admitidos dependen del modelo.
Ajustes de los filtros de seguridad.
Herramientas de Gemini como functionDeclarations. Los tipos de herramientas admitidos dependen del modelo.
Configuración de herramientas como functionCallingConfig.
Nombre del contenido en caché creado con Crear contenido en caché, por ejemplo cachedContents/abc123. Solo funciona en el Workspace que lo creó.
Cada campo en lowerCamelCase mostrado arriba también puede utilizar su ortografía oficial de proto en snake_case, por ejemplo system_instruction, generation_config, safety_settings, tool_config, cached_content, file_data.file_uri e inline_data.mime_type.
Métodos admitidos
La API compatible con Gemini incluye Listar modelos, Obtener modelo, generateContent, streamGenerateContent, countTokens, Files y contenido en caché. Gemini Interactions y Live no están disponibles.
Lea la respuesta de Obtener modelo del modelo antes de llamarlo: supportedGenerationMethods enumera las acciones que dicho modelo acepta.
Respuesta
Candidatos de contenido generado.
Información sobre el uso de tokens.
Solicitud
curl -X POST "https://api.tokenlab.sh/v1beta/models/gemini-2.5-pro:generateContent?key=sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"parts": [{"text": "Hello, Gemini!"}]
}
],
"generationConfig": {
"temperature": 0.7,
"maxOutputTokens": 1024
}
}'Errores
400 INVALID_ARGUMENT: el cuerpo no es válido o el modelo no acepta solicitudes de Gemini.401 UNAUTHENTICATED: la API key falta o no es válida.402 RESOURCE_EXHAUSTED: el saldo es demasiado bajo para esta solicitud.503 UNAVAILABLE: no hay ninguna ruta disponible para el modelo en este momento. Reintente más tarde.
Entrada multimedia
Coloque el contenido multimedia dentro de contents[].parts[] como bytes en Base64 en línea (inlineData o inline_data) o como una URL https pública (fileData o file_data). Se admiten imágenes, audio y video.
Imagen
Utilice bytes de imagen en línea:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"inlineData": {
"mimeType": "image/jpeg",
"data": "/9j/4AAQSkZJRgABAQ..."
}
}
]
}
]
}Utilice una URL de imagen:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Please describe this image." },
{
"fileData": {
"mimeType": "image/jpeg",
"fileUri": "https://example.com/demo.jpg"
}
}
]
}
]
}Audio
Utilice una URL de audio, aquí con los nombres en snake_case de proto:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Transcribe and summarize this audio." },
{
"file_data": {
"mime_type": "audio/mpeg",
"file_uri": "https://example.com/sample.mp3"
}
}
]
}
]
}Video
Utilice una URL de video:
{
"contents": [
{
"role": "user",
"parts": [
{ "text": "Describe this video briefly." },
{
"fileData": {
"mimeType": "video/mp4",
"fileUri": "https://example.com/sample.mp4"
}
}
]
}
]
}Respuesta
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{"text": "Hello! How can I assist you today?"}
]
},
"finishReason": "STOP",
"safetyRatings": [
{"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
]
}
],
"usageMetadata": {
"promptTokenCount": 5,
"candidatesTokenCount": 10,
"totalTokenCount": 15
}
}Conteo de tokens y embeddings
Contar tokens (POST /v1beta/models/{model}:countTokens) requiere una API key y no se factura. Utilice el conteo para la planificación; el cobro por una solicitud de generación proviene de usageMetadata de esa respuesta.
Los modelos de embeddings utilizan Crear embedding (POST /v1/embeddings). Llame a embedContent o batchEmbedContents solo para un modelo cuya respuesta de Obtener modelo los incluya en supportedGenerationMethods.
Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
Nombre del modelo (ej. gemini-2.5-pro)
Parámetros de consulta
Clave de API (alternativa a la autenticación por encabezado)
Encabezados
Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.
Valores permitidos
- "auto"
- "verified"
- "official"
Cuerpo de la solicitud
application/json
Solicitud nativa de Gemini GenerateContent. Se aceptan y conservan tanto los nombres lowerCamelCase de ProtoJSON como los nombres snake_case del proto original, incluyendo solicitudes mixtas. Si ambas grafías de un campo están presentes, TokenLab no las fusiona ni elige una precedencia local. Los campos desconocidos se reenvían bajo un criterio de mejor esfuerzo.
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json