Interfaz de todos los modelos Gemini - formato de API nativa
Selecciona el modelo de texto Gemini que deseas invocar mediante {model} en la ruta (consulta la tabla de referencia del parámetro model para ver todos los valores posibles).
- Usa el formato de API nativa de Google y devuelve el contenido de la conversación de forma síncrona
- Entrada de texto plano / multimodal: entrada mixta de texto + imagen / audio / video
- Streaming: reemplaza
generateContentporstreamGenerateContenten la ruta (puedes añadir?alt=ssepara obtener SSE)
Especificaciones y diferencias de los modelos
- Parámetros de muestreo
temperature/topP/topK: consistente en toda la serie Gemini 3.x, los valores personalizados no afectan a la salida;topKse descarta directamente en el gateway (no se envía al upstream) ytemperature/topPdevuelven un 400 si están fuera del rango válido. - Control del razonamiento: la serie Gemini 3.x usa
thinkingConfig.thinkingLevel(consulta el parámetrothinkingLevelpara ver los niveles admitidos y el valor por defecto de cada modelo); la serie Gemini 2.5 usathinkingConfig.thinkingBudget(entero,0=desactivado). Ambos son mutuamente excluyentes. - Llamadas a funciones: en Gemini 3.x, el
FunctionResponsedebe devolver elidy elnameque coincidan con elFunctionCallcorrespondiente; de lo contrario, se produce un error. - Rol del último turno: el
roledel último mensaje no puede sermodel(Gemini 3.5+ devuelve un error). - Límite de tokens:
gemini-3.6-flash/gemini-3.5-flash-litetienen un contexto de 1,048,576 y una salida máxima de 65,536; el resto de los modelos se rigen por sus propias especificaciones.
https://direct.evolink.ai, que ofrece mejor compatibilidad con modelos de texto y admite conexiones persistentes. https://api.evolink.ai es el endpoint principal para servicios multimodales y actúa como dirección de respaldo para los modelos de texto.Autorizaciones
##Todas las APIs requieren autenticación Bearer Token##
Obtener API Key:
Visita la Página de gestión de API Key para obtener tu API Key
Agregar al encabezado de la solicitud:
Parámetros de ruta
Selecciona el modelo de texto Gemini que deseas invocar:
gemini-3.6-flash, gemini-3.5-flash, gemini-3.5-flash-lite, gemini-3.1-pro-preview, gemini-3.1-pro-preview-customtools, gemini-3.1-flash-lite-preview, gemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite "gemini-3.6-flash"
Cuerpo
List of conversation contents, supports multi-turn dialogue and multimodal input
1Generation configuration parameters (optional)
System instruction (optional), mainly text content
List of tools the model can call, such as function calling or code execution
Tool calling configuration (optional)
Safety settings list (optional)
Cached content name, in the form cachedContents/{cachedContent}
Respuesta
Contenido generado exitosamente
Descripción del formato de respuesta:
- Al usar el endpoint
generateContent, devuelveGenerateContentResponse(devuelve la respuesta completa de una vez) - Al usar el endpoint
streamGenerateContent, devuelveStreamGenerateContentResponse(respuesta en streaming, devuelve contenido en fragmentos)