Guía para desarrolladores de Gemini 3.7 Flash

Gemini 3.7 Flash es nuestro controlador inteligente de uso diario para desarrolladores y representa un avance en la ingeniería de software, ya que es mucho mejor para compilar. Este modelo ofrece una mejor inteligencia para tareas complejas, el seguimiento de instrucciones y las llamadas a herramientas en tus flujos de trabajo diarios.

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

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

Gemini 3.7 Flash es el caballo de batalla principal de la familia Gemini 3, ya que une la brecha entre los modelos Pro de razonamiento profundo y los modelos Gemini Flash-Lite de alto rendimiento, al mismo tiempo que ofrece una alta eficiencia de tokens y un procesamiento multimodal de varios pasos.

Especificaciones y comparaciones de modelos

En la siguiente tabla, se comparan algunas de las especificaciones entre 3.7 Flash, 3.6 Flash y 3.1 Pro:

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

¿Qué novedades incluye Gemini 3.7 Flash?

En la siguiente tabla, se comparan los parámetros de evaluación estándar para desarrolladores entre Gemini 3.7 Flash y 3.6 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.7-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.7-flash:generateContent \
-d '{
  "contents": {
    "role": "USER",
    "parts": { "text": "Why is the sky blue?" },
  },
}'

Reglas obligatorias de la API y convenciones de comportamiento

Gemini 3.7 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 cambio, 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 del 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.

Cómo migrar a 3.7 Flash desde 3.5 Flash o 3.6 Flash

Para migrar a 3.7 Flash desde 3.5 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.7-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: Es 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.7 Flash
• Notebook introductorio