Guía para desarrolladores de Gemini 3.8 Flash

Gemini 3.8 Flash es nuestro modelo de alto rendimiento más inteligente hasta ahora, que ofrece mejoras significativas en comparación con 3.7 Flash en ingeniería de software, tareas de agentes y razonamiento de varios pasos crítico en dominios especializados. 3.8 Flash ofrece ganancias sustanciales en comparación con 3.7 Flash y, a menudo, se acerca al rendimiento de los modelos de frontera de mayor costo.

En este documento, se explica qué novedades incluye 3.8 Flash, cómo se adapta a la familia de modelos de Gemini, cómo migrar a 3.8 Flash y se proporciona una guía de inicio rápido para usar 3.8 Flash.

¿Cómo se adapta a la familia de Gemini?

La línea Gemini Flash es el modelo de alto rendimiento principal de la familia Gemini 3, que une la brecha entre los modelos Pro de razonamiento profundo y los modelos Gemini Flash-Lite de alto rendimiento, al tiempo que ofrece una alta eficiencia de tokens y un procesamiento multimodal de varios pasos.

En comparación con 3.7 Flash, 3.8 Flash ofrece una mejor precisión y un rendimiento más confiable a costa de un mayor consumo de tokens. Sin embargo, 3.8 Flash también incluye el control de esfuerzo a través de niveles de razonamiento para que puedas modular este consumo. En el nivel de razonamiento medio, aún puedes resolver tareas complejas de agentes y reducir el consumo de tokens. También puedes usar niveles de razonamiento más bajos para tareas sensibles a la latencia para evitar por completo la sobrecarga de procesamiento. Si quieres optimizar la eficiencia de procesamiento, considera usar 3.7 Flash.

Especificaciones y comparaciones de modelos

En la siguiente tabla, se incluye una comparación que abarca algunas de las especificaciones entre 3.8 Flash, 3.7 Flash y 3.1 Pro:

Consulta la página del modelo 3.8 Flash para obtener la lista completa de capacidades, herramientas y opciones de consumo compatibles.

¿Qué novedades incluye Gemini 3.8 Flash?

En la siguiente tabla, se comparan las comparativas de evaluación estándar para desarrolladores entre Gemini 3.8 Flash y 3.7 Flash:

Guía de inicio rápido

Antes de comenzar, debes autenticarte en Agent Platform con las credenciales predeterminadas de la aplicación (ADC) o una clave de API. Consulta Cómo comenzar a usar Gemini Enterprise Agent Platform para obtener más información.

En los siguientes bloques de código, reemplaza PROJECT_ID por el ID de tu proyecto.

Instalación

Asegúrate de usar el SDK de google-genai más reciente:

pip install --upgrade google-genai

Solicitud básica

from google import genai

client = genai.Client(enterprise=True, project="PROJECT_ID", location="global")

response = client.models.generate_content(
  model="gemini-3.8-flash",
  contents="How does AI work?",
)
print(response.text)

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/global/publishers/google/models/gemini-3.8-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Reglas obligatorias de la API y convenciones de comportamiento

Gemini 3.8 Flash aplica estrictamente las siguientes convenciones estándar de la API de la familia Gemini 3:

• Parámetros de muestreo obsoletos (temperature, top_k, top_p): El backend ignora estos parámetros. En su lugar, puedes controlar el determinismo con thinking_level (LOW, MEDIUM, HIGH) y response_schema o json_schema.
• Parámetros no admitidos (frequency_penalty, presence_penalty, candidate_count): Si pasas frequency_penalty, presence_penalty o candidate_count, se mostrará un error de API activo. Quítalos del código de cliente heredado.

• Reglas estrictas de llamadas a funciones: Un turno FunctionResponse debe coincidir estrictamente con el id, el name y el recuento de ejecución del FunctionCall anterior.

  • Recursos multimodales: Coloca siempre los recursos multimodales dentro de la carga útil de la respuesta.
  • Formato y texto previo a la herramienta: Da formato a las instrucciones intercaladas con \n\n. Si encuentras errores de Malformed_Function_Call vinculados al texto previo a la herramienta, limpia los comentarios principales antes de las llamadas a la herramienta.

  • Para pasar notas de trabajo intermedias o actualizaciones de estado antes de una llamada a la herramienta, inclúyelas en una llamada a función update() dedicada en lugar de emitir XML o texto sin procesar:

    {
      "name": "update",
      "description": "Update working notes before tool execution",
      "parameters": {
        "type": "OBJECT",
        "properties": {
          "previous_step": {"type": "STRING"},
          "plan": {"type": "STRING"},
          "next_step": {"type": "STRING"}
        },
        "required": ["previous_step", "plan", "next_step"]
      }
    }
    

• Validación de secuencia de chat:

  • Las cargas útiles del historial no pueden terminar con un turno de rol "model".
  • Los turnos de modelo rellenados previamente no son compatibles y deben quitarse cuando se realiza la actualización.
  • Los turnos vacíos en el historial de conversaciones se descartan automáticamente o producirán errores de validación.

3.8 Flash desde 3.7 Flash o 3.6 Flash

Para migrar a 3.8 Flash desde 3.7 Flash o 3.6 Flash, sigue estos pasos:

1. Actualiza el ID del modelo: Cambia la cadena del modelo en tus llamadas a la API a gemini-3.8-flash.
2. Reemplaza el parámetro de presupuesto de razonamiento: Reemplaza las configuraciones de números enteros thinking_budget por la enumeración de cadenas thinking_level establecida en uno de los siguientes valores:
   • HIGH: Se recomienda para el control de calidad visual denso, la detección de movimientos en fracciones de segundo (deportes, edición) o el razonamiento de varios pasos en videos de más de 60 minutos.
   • MEDIUM: El nivel de razonamiento predeterminado. Este nivel proporciona un equilibrio óptimo para las preguntas y respuestas generales de video, el resumen de conferencias y la recuperación de clips.
   • LOW: Se recomienda para tareas como búsquedas rápidas enfocadas en transcripciones o extracción básica de metadatos.
3. Quita los parámetros obsoletos y no admitidos:
   • Quita temperature, top_p y top_k.
   • Quita candidate_count, frequency_penalty y presence_penalty.
   • Quita los turnos de modelo rellenados previamente de los historiales de conversaciones.

Lista de tareas de resumen para desarrolladores

Recursos adicionales

• Página del modelo Gemini 3.8 Flash
• Notebook introductorio