Novedades de Gemini 3.8 Flash

3.6 Flash y 3.5 Flash-Lite Otros modelos

Gemini 3.8 Flash (gemini-3.8-flash) tiene disponibilidad general (DG) y está listo para su uso en producción. Es nuestro modelo Flash más inteligente, diseñado para ingeniería de software a largo plazo, agentes autónomos y flujos de trabajo empresariales complejos.

En esta guía, se explican las novedades de Gemini 3.8 Flash, los cambios en la API, los ejemplos de código y la orientación para la migración.

Modelo nuevo

Gemini 3.8 Flash admite una ventana de contexto de 1 millón de tokens, un máximo de 64, 000 tokens de salida, niveles de pensamiento ajustables (low, medium, high) y el mismo conjunto de herramientas integradas.

Para ver las especificaciones completas, consulta la página del modelo Gemini 3.8 Flash. Para obtener detalles sobre los precios de introducción, consulta la sección de precios a continuación o la página de precios.

Guía de inicio rápido

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="Write a three.js script that renders a realistic 3D black hole."
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Write a three.js script that renders a realistic 3D black hole.",
});

console.log(response.text);

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Write a three.js script that renders a realistic 3D black hole."}]
    }]
  }'

Novedades de Gemini 3.8 Flash

• Ingeniería de software a largo plazo: Ofrece resultados sólidos en comparativas de programación del mundo real, refactorización compleja de varios archivos y ejecución determinística de herramientas. Consulta la metodología de evaluación para obtener más detalles.
• Agentes autónomos: Te permite crear flujos de trabajo de planificación y organización de herramientas de varios pasos resilientes, lo que reduce considerablemente los bucles y errores fallidos.
• Flujos de trabajo empresariales complejos: Ofrece una precisión superior, un razonamiento profundo y un alto rigor fáctico en tareas de dominio exigentes y canalizaciones de datos a gran escala.
• Modelo predeterminado para los agentes administrados: El agente predeterminado para los agentes administrados, el agente de Antigravity, ahora usa Gemini 3.8 Flash. El SDK de Antigravity también usa Gemini 3.8 Flash de forma predeterminada.
• Precios de lanzamiento: Gemini 3.8 Flash está disponible a una tarifa de lanzamiento de USD 0.75 por 1 M de tokens de entrada y USD 3.75 por 1 M de tokens de salida hasta el 31 de diciembre de 2026. Los precios estándar de USD 1.50 por 1 millón de tokens de entrada y USD 7.50 por 1 millón de tokens de salida entrarán en vigencia el 1 de enero de 2027.

Por diseño, Gemini 3.8 Flash puede usar más tokens en tareas complejas y de mayor duración. Para ofrecer resultados de mayor calidad en objetivos difíciles de varios pasos, el modelo realiza pasos de razonamiento más pequeños, llama a las herramientas de forma iterativa y verifica su trabajo a lo largo del proceso. No todos los flujos de trabajo necesitan este nivel de verificación. Para las tareas diarias, puedes reducir el esfuerzo de razonamiento para disminuir el consumo de tokens. Como alternativa, Gemini 3.6 Flash sigue siendo compatible.

Cómo comprender los niveles de razonamiento

Gemini 3.8 Flash te brinda un control flexible sobre la latencia y la inteligencia, ya que te permite ajustar el nivel de razonamiento del modelo:

• Bajo esfuerzo de razonamiento: Reduce el tiempo de respuesta para tareas críticas de latencia, como canalizaciones de respuesta ante incidentes, chat en tiempo real, redacción de borradores y análisis de datos rápidos.
• Mediana (predeterminada): Es la mejor calidad para la mayoría de las tareas. Se recomienda para casos de uso complejos de código y con agentes, ya que proporciona una mayor precisión en la primera revisión.
• Alto esfuerzo de pensamiento: Maximiza las capacidades de razonamiento y organización de herramientas del modelo. Ideal para razonamiento profundo, matemáticas y tareas difíciles de varios pasos.

En el siguiente ejemplo, se configura thinking_level como medium para una solicitud de análisis de código compleja:

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="gemini-3.8-flash",
    contents="Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
    config=types.GenerateContentConfig(
        thinking_config=types.ThinkingConfig(
            thinking_level="medium"  # Balanced reasoning effort for complex tasks
        ),
    ),
)

print(response.text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: "gemini-3.8-flash",
  contents: "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely.",
  config: {
    thinkingConfig: {
      thinkingLevel: "medium", // Balanced reasoning effort for complex tasks
    },
  },
});

console.log(response.text);

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [{
      "parts": [{"text": "Analyze this payment processing pipeline for race conditions during retry attempts and rewrite the transaction locks safely."}]
    }],
    "generationConfig": {
      "thinkingConfig": {
        "thinkingLevel": "medium"
      }
    }
  }'

Se actualizó el agente de Antigravity

Lista de tareas de migración

  `/gemini-api-dev migrate my app to Gemini 3.8 Flash`

Migra a gemini-3.8-flash

• Actualiza el ID del modelo: Cambia la cadena del modelo objetivo a gemini-3.8-flash.
• Configura el nivel de pensamiento: Reemplaza thinking_budget por la cadena de enumeración thinking_level. Ten en cuenta que minimal no se admite en Gemini 3.8 Flash. Elige low, medium (predeterminado) o high.
• Aplica los cambios en los parámetros de la API de Gemini 3: Quita los parámetros de muestreo desaprobados (temperature, top_p, top_k), candidate_count (no compatible con Gemini 3 ni versiones posteriores) y los turnos del modelo rellenados previamente. Consulta Cambios en la API de Gemini 3.6 y actualizaciones de parámetros.
• Aplicar reglas de validación de turnos: Quita los turnos del modelo completados previamente y asegúrate de que el turno final del usuario contenga texto no vacío.
• Audita las llamadas a función:
  • Coloca los recursos multimodales dentro de la carga útil de la respuesta.
  • Da formato a las instrucciones intercaladas con \n\n.
  • Si ves errores Malformed_Function_Call vinculados al texto previo a la herramienta, consulta Soluciones alternativas para los requisitos de texto previo a la herramienta.
  • Solo si se usa la API de generateContent: Asegúrate de que todos los objetos FunctionResponse incluyan call_id y name.
• Requisitos básicos de Gemini 3: Para las actualizaciones del SDK y la conservación de la firma de pensamiento, consulta Firmas de pensamiento.

Precios

Aprovecha los precios de lanzamiento en Google AI Studio y Gemini Enterprise Agent Platform hasta el 31 de diciembre de 2026 para Gemini 3.8 Flash y Gemini 3.6 Flash. Los precios estándar entrarán en vigencia el 1 de enero de 2027. Para conocer los precios completos, consulta la página de precios.

Otros modelos

• Gemini 3.6 Flash y 3.5 Flash-Lite
• Ver todos los modelos

¿Qué sigue?

• Revisa las especificaciones de la API en la Descripción general de los modelos.
• Explora la organización de varios agentes en la Descripción general de la API de Interactions.
• Probar y definir instrucciones en Google AI Studio