Tras abrir Gemini 4 Carbon el 10 de noviembre, ¿cómo fijar thinking_level, background y usage en el JSON de Interactions antes del precio del 1 de diciembre?

Solo nivel de pago. $2/$10 hasta el 30 de noviembre y luego $4/$20. thinking_level es low, medium o high; la salida larga necesita background y un max_output_tokens mayor.

Cambiar la cadena del modelo a gemini-4-carbon no cierra la petición. El 10 de noviembre de 2026 Google abrió Gemini 4 Carbon en la API de Gemini de pago, en Google AI Studio y para suscriptores de AI Ultra en Antigravity. El precio de introducción hasta el 30 de noviembre es de $2 por millón de tokens de entrada y $10 por millón de salida; la salida incluye los tokens de thinking. Desde el 1 de diciembre esas tarifas pasan a $4 y $20. Los aciertos de la caché implícita tienen un 95 por ciento de descuento ($0.10 y luego $0.20). Carbon no está en el nivel gratuito.

Esta página está fechada el 13 de noviembre de 2026, a partir de la guía del 10 de noviembre y de What's new. Hace tres días cubrimos effort y usage de Fable 5.2. Los controles de Carbon viven en la API Interactions: generation_config.thinking_level, background y usage.

Qué se abrió el 10 de noviembre

Google presenta Carbon como su modelo de razonamiento más fuerte para ingeniería de largo recorrido, archivos multimodales densos y trabajo científico. El id es gemini-4-carbon. El nivel de pensamiento por defecto es medium. Entrada, thinking y salida comparten una ventana de 1.048.576 tokens. Una respuesta síncrona se detiene en 65.536 tokens salvo que actives la descodificación larga.

gemini-4-argon comparte esa ventana, los mismos valores de thinking_level, las herramientas integradas y el mismo precio de introducción. Carbon gasta más tokens de thinking por turno. Deja el código interactivo en Argon. Pasa a Carbon la causa raíz, la arquitectura y los bucles de verificación.

PeriodoEntrada / 1 MSalida, thinking incluido / 1 MEntrada en caché / 1 M
Hasta el 30 de noviembre de 2026$2$10$0.10
Desde el 1 de diciembre de 2026$4$20$0.20

JSON de la petición y thinking_level

POST a https://generativelanguage.googleapis.com/v1beta/interactions con x-goog-api-key y Content-Type: application/json. La profundidad va en generation_config.thinking_level, no en un presupuesto numérico.

{
  "model": "gemini-4-carbon",
  "input": "Analyze this payment pipeline for race conditions during retries and rewrite the locks.",
  "generation_config": {
    "thinking_level": "medium"
  }
}
thinking_levelPara qué lo indica la guía de Carbon
lowEnrutado, clasificación y extracción puntual
mediumValor por defecto. La mayoría de turnos de código y de agente
highCausa raíz, matemática formal y arquitectura

Si omites thinking_level, el servidor usa medium. La guía de Carbon documenta low, medium y high. El enum compartido de Interactions también lista minimal y xhigh para otros modelos; no los envíes hasta que la página de Carbon los nombre. thinking_budget está en desuso y devuelve un aviso. max_output_tokens limita thinking y texto visible juntos. Un tope bajo corta la respuesta antes de que el modelo termine de razonar.

background y descodificación larga

Para pasar de 65.536 tokens, pon background en true en el nivel superior y max_output_tokens por encima de 65536. El techo es 1.048.576 menos la entrada. background: true sin max_output_tokens sigue parando en 64K.

{
  "model": "gemini-4-carbon",
  "input": "Write a complete proof of the prime number theorem.",
  "background": true,
  "generation_config": {
    "thinking_level": "high",
    "max_output_tokens": 262144
  }
}

La guía de Carbon consulta mientras status sea in_progress o queued. El recurso Interaction también usa completed, failed, cancelled, incomplete, requires_action y requires_continuation. incomplete significa que se alcanzó el tope. Por HTTP lees el id con GET /v1beta/interactions/{id}. El ejemplo de fondo de la guía de inicio envía la cabecera Api-Revision: 2026-05-20 en ese GET.

Cada salto de descodificación larga añade otro elemento de steps[] con type: model_output. Une cada parte de texto. Leer solo steps[0] deja fuera el resto. previous_interaction_id continúa el historial y no reenvía generation_config, tools ni system_instruction; vuelve a mandar thinking_level en la siguiente llamada. store es true por defecto (el nivel de pago conserva las interactions 55 días). store: false no se combina con background: true.

Campos que hay que quitar del JSON antiguo de Gemini

Al venir de Gemini 3 o anterior, What's new y la guía piden cambiar el JSON, no solo el id del modelo:

  • temperature, top_p y top_k se ignoran. La guía dice que devuelven un aviso de desuso.
  • Quita cached_content explícito y caches.create. La caché implícita empieza en 4.096 tokens y descuenta los aciertos un 95 por ciento.
  • Sustituye thinking_budget por thinking_level.
  • Si max_output_tokens está por debajo de 32.768, súbelo al menos a 32.768. Para gastar menos tokens, baja el nivel de pensamiento.
  • Los prompts difíciles pueden tardar minutos. Usa background, o un tiempo de espera HTTP de al menos 15 minutos.

Tu propio esquema JSON sigue en los campos de esquema de la respuesta. Mira JSON estructurado con la API de Gemini y qué es la salida estructurada. Carbon no convierte un juicio en probabilidades; eso es otro endpoint.

usage antes del precio del 1 de diciembre

Una interaction terminada trae usage. En la muestra publicada, 7 de entrada + 20 de salida + 22 de thought suman total_tokens 49, así que total_thought_tokens no está dentro de total_output_tokens.

{
  "id": "v1_example",
  "object": "interaction",
  "model": "gemini-4-carbon",
  "status": "completed",
  "steps": [
    {
      "type": "model_output",
      "content": [{ "type": "text", "text": "..." }]
    }
  ],
  "usage": {
    "total_input_tokens": 7,
    "total_cached_tokens": 0,
    "total_output_tokens": 20,
    "total_thought_tokens": 22,
    "total_tool_use_tokens": 0,
    "total_tokens": 49,
    "input_tokens_by_modality": [{ "modality": "text", "tokens": 7 }]
  }
}

Cobra la entrada no cacheada a la tarifa de entrada, total_cached_tokens al 5 por ciento de esa tarifa, y total_output_tokens más total_thought_tokens a la tarifa de salida. No sumes también total_tokens. Las consultas de Grounding se cobran aparte, y las instrucciones de herramientas cuentan como tokens procesados. Guarda el objeto usage entero para aplicar el precio del 1 de diciembre a registros que ya tienes.

Enrutado de Argon y agent_config

Separa los modelos en la configuración. Argon se queda en la vía rápida al mismo precio de lista; Carbon toma los turnos que gastan tokens de thinking.

{
  "routes": [
    { "if": { "task": "interactive_coding" }, "model": "gemini-4-argon", "thinking_level": "medium" },
    { "if": { "task": "root_cause" }, "model": "gemini-4-carbon", "thinking_level": "high", "background": true }
  ]
}

Los agentes gestionados ponen el modelo dentro de agent_config. generation_config vale cuando está model; agent_config es el otro camino.

{
  "agent": "antigravity-preview-09-2026",
  "environment": "remote",
  "input": "Audit the site for Core Web Vitals and return a scorecard.",
  "agent_config": {
    "type": "antigravity",
    "model": "gemini-4-carbon"
  }
}

JSON que hay que revisar antes de publicar

  1. El cuerpo lleva gemini-4-carbon, thinking_level en low, medium o high, y no lleva temperature, top_p, top_k, thinking_budget ni cached_content.
  2. Toda llamada que deba pasar de 64K pone background: true y max_output_tokens por encima de 65536.
  3. El analizador une cada texto de model_output y guarda status.
  4. La factura separa entrada, entrada en caché, salida y tokens de thought, con las tarifas del 1 de diciembre listas.

Compruébalo en local con el validador JSON, JSONPath ($.usage.total_thought_tokens) y JSON Diff contra la petición anterior. No se sube nada.

FAQ

¿gemini-4-carbon está en el nivel gratuito?

No. What's new lo limita al nivel de pago. El precio de introducción de $2/$10 llega hasta el 30 de noviembre de 2026; después es $4/$20.

¿Puedo enviar thinking_level xhigh?

La guía de Carbon documenta low, medium y high. minimal y xhigh aparecen en el enum compartido de Interactions para otros modelos. No copies valores de effort de Claude en este campo.

¿Por qué la respuesta se detiene en 64K tokens?

Las respuestas síncronas paran en 65.536. Pon background en true y max_output_tokens por encima de 65536. background solo sigue en 64K. status incomplete significa que se alcanzó el tope.

¿La factura debe usar total_tokens?

No. Entrada no cacheada a la tarifa de entrada, total_cached_tokens al 5 por ciento, y total_output_tokens más total_thought_tokens a la tarifa de salida. Sumar total_tokens cuenta dos veces.

¿previous_interaction_id conserva thinking_level?

No. Reenvía generation_config, tools y system_instruction en la siguiente interaction. El id conserva el historial.

¿Puedo dejar una caché de contexto explícita?

No. Quita cached_content. La caché implícita aplica desde 4.096 tokens y descuenta los aciertos un 95 por ciento.

Resumen

Carbon, abierto el 10 de noviembre de 2026, cambia cuánto piensa el modelo y qué pagas después del 30 de noviembre. Usa gemini-4-carbon con thinking_level en low, medium o high. Si la respuesta debe pasar de 64K, junta background: true con max_output_tokens por encima de 65536. Factura los tokens de thought aparte de la salida visible, y quita los campos de muestreo y las cachés explícitas antes de enviar.