
La Gemini 4 Carbon API ya está disponible en PoYo con el ID de modelo gemini-4-carbon. Puedes llamarla a través del endpoint Chat Completions compatible con OpenAI o con el formato nativo generateContent de Google usando una sola clave de PoYo, a 1,60 $ por cada millón de tokens de entrada y 8,00 $ por cada millón de tokens de salida. Pruébala en la página del modelo Gemini 4 Carbon antes de escribir una sola línea de código.
Este resumen explica qué dice Google que es el modelo, los límites que debes tener en cuenta en tu diseño, el precio en PoYo y en Google, y qué solicitudes merece la pena enviar a Carbon en lugar de a Gemini 4 Argon.
¿Qué es Gemini 4 Carbon?
Google presentó Gemini 4 Carbon el 28 de octubre de 2026 como «nuestro modelo más potente, con capacidades de ciberseguridad y de horizonte largo de última generación». Se basa en Gemini 4 Argon, lanzado dos semanas antes, y según Google está «diseñado para flujos de trabajo agénticos sostenidos»: encontrar la causa raíz de bugs y corregirlos en bases de código grandes, programación multiagente, migraciones, trabajo de conocimiento denso y razonamiento científico.
El acceso llegó en dos fases:
| Fecha | Qué ocurrió |
|---|---|
| 28 de octubre de 2026 | Google anuncia Gemini 4 Carbon; primer acceso para un subconjunto de defensores de ciberseguridad a través del Fairwind Program |
| 10 de noviembre de 2026 | Disponible para todos los desarrolladores de pago en el nivel de pago de la Gemini API (AI Studio) y en Gemini para empresas |
| 16 de noviembre de 2026 | Disponible en PoYo como gemini-4-carbon |
Google indica que algunas capacidades de ciberseguridad siguen restringidas: los desarrolladores solicitan el acceso al Fairwind Program «para obtener acceso a Carbon para ciberseguridad de forma progresiva». Tenlo en cuenta al planificar funciones de seguridad defensiva.
Gemini 4 Carbon API de un vistazo
| Elemento | Valor |
|---|---|
| ID de modelo en PoYo | gemini-4-carbon |
| Código de modelo de Google | gemini-4-carbon (una única versión estable, sin alias publicados) |
| Ventana de contexto | 1,048,576 tokens, compartidos entre entrada y salida |
| Salida máxima | 65,536 tokens por defecto (Google indica hasta 1M solo con «long decode») |
| Tipos de entrada | Texto, imagen, audio, vídeo, PDF |
| Tipo de salida | Texto |
| Fecha de corte de conocimiento | Marzo de 2026 |
| Nivel gratuito en Google | Ninguno |
| Formatos en PoYo | Chat Completions y Gemini Native (no Responses ni Anthropic Messages) |
La página del modelo de Google presenta la cifra de 1M como un límite unificado de entrada y salida, así que un prompt de 1.000.000 de tokens apenas deja espacio para la respuesta. La documentación de PoYo no describe ningún interruptor de long decode, así que planifica con 64K de salida por respuesta en PoYo.
Endpoints y autenticación
Ambos formatos usan Authorization: Bearer $POYO_API_KEY contra https://api.poyo.ai. Las respuestas llegan con la estructura nativa de cada formato, sin el envoltorio code / data que PoYo usa para las tareas multimedia.
| Formato | Endpoint | Streaming | Campo de salida máxima |
|---|---|---|---|
| OpenAI Chat Completions | POST https://api.poyo.ai/v1/chat/completions | "stream": true (SSE) | max_tokens |
| Gemini Native | POST https://api.poyo.ai/v1beta/models/gemini-4-carbon:generateContent | :streamGenerateContent (SSE) | generationConfig.maxOutputTokens |
Usa Chat Completions si ya trabajas con el SDK de OpenAI (define base_url como https://api.poyo.ai/v1). Usa Gemini Native cuando necesites partes inlineData para imágenes y otros archivos: el esquema de Chat Completions de PoYo documenta content como una cadena simple. Si envías el modelo a un formato no compatible, como /v1/responses, obtendrás un HTTP 400 con la lista de URI admitidas. Las estructuras de las solicitudes están en la documentación de Gemini Native.
Google también indica llamadas a funciones, salidas estructuradas, niveles de razonamiento (thinking levels) y grounding con la Búsqueda de Google para este modelo. Los esquemas publicados por PoYo para estos dos endpoints solo documentan los mensajes, contents / parts, los campos de muestreo, generationConfig y safetySettings, así que consulta la documentación antes de depender de cualquier otra cosa.
Precio de la Gemini 4 Carbon API: PoYo frente a Google
PoYo factura por token en créditos (1 crédito = 0,005 $):
| Medidor (por 1M de tokens) | Precio en PoYo | Créditos en PoYo | Google, hasta el 30 nov. 2026 | Google, desde el 1 dic. 2026 |
|---|---|---|---|---|
| Entrada | $1.60 | 320 | $2.00 | $4.00 |
| Salida (incl. tokens de razonamiento) | $8.00 | 1,600 | $10.00 | $20.00 |
| Lectura de caché | $0.08 | 16 | $0.10 | $0.20 |
Las tarifas de PoYo son un 20% más bajas que los precios introductorios de entrada y salida de Google. La página de precios de Google indica que los tokens de razonamiento están incluidos en la tarifa de salida y que Carbon solo admite caché de contexto implícita. Los precios de Google de la tabla son los del nivel estándar. Google también publica tarifas por lotes (batch), que no forman parte de este endpoint de PoYo. Los precios de PoYo son los publicados el 16 de noviembre de 2026; la página del modelo es la fuente actualizada.
Una revisión de un repositorio de 200K tokens con una respuesta de 8K tokens cuesta 0.2 × $1.60 + 0.008 × $8.00 = $0.384 (76,8 créditos) en PoYo. Tienes ejemplos completos en precios de la Gemini 4 Carbon API.
Qué solicitudes enviar a la Gemini 4 Carbon API
Aquí los benchmarks solo importan como criterio de enrutamiento. Según la tabla publicada por Google:
| Carga de trabajo | Benchmark | Carbon | Argon | ¿Enviar a Carbon? |
|---|---|---|---|---|
| Programación agéntica en terminal | Terminal-Bench 4.0 (AA) | 65.2% | 57.1% | Sí, para tareas largas de varios pasos |
| Programación agéntica de horizonte largo | SWE-sweep | 9.6% | 4.3% | Sí |
| Recuperación en 256K–1M tokens | GraphWalks (BFS F1) | 96.2% | 84.2% | Sí, cuando el prompt es enorme |
| Automatización empresarial entre herramientas | AutomationBench (Zapier) | 53.9% | 51.3% | Diferencia pequeña; prueba ambos |
| Detección de vulnerabilidades | SEC-bench Pro | 88.2% | 83.4% | Sí, si tienes acceso a Fairwind |
| Calidad de parches para debilidades | CWE-bench | 71.0% | 68.0% | Sí |
En la misma tabla, GPT-6 Astra va por delante en FrontierSWE 2 (65,5% frente a 61,2%) y Claude Opus 5.5 en OSWorld-2.1 (87,2% frente a 81,5%). Para una comparación a tres bandas, consulta Gemini 4 Carbon API frente a Claude Opus 5.5 y GPT-6 Astra.
Carbon frente a Argon: una regla de enrutamiento
Carbon y Argon tienen el mismo precio de entrada y salida, tanto en PoYo como en Google. La diferencia está en los tokens por tarea: según Google, Carbon trabaja «usando más tokens que Argon para explorar a fondo, razonar en profundidad y ejecutar bucles de verificación extensos», y «Argon sigue siendo la opción ideal para la mayoría del trabajo de ingeniería de software y de conocimiento». Así que envía el trabajo diario de programación y documentos a gemini-4-argon. Envía la depuración más difícil, las migraciones, la recuperación en millones de tokens y el trabajo de seguridad a gemini-4-carbon. Como ambos usan la misma estructura de solicitud, el cambio consiste solo en el ID de modelo. Tienes los detalles en Gemini 4 Carbon API frente a Gemini 4 Argon y en la guía de la API de Gemini 4 Argon.
Inicio rápido con la Gemini 4 Carbon API
curl https://api.poyo.ai/v1/chat/completions \
-H "Authorization: Bearer $POYO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-4-carbon",
"messages": [
{"role": "system", "content": "You are a senior engineer. Answer with a numbered plan."},
{"role": "user", "content": "Plan a migration of a Flask service from SQLAlchemy 1.4 to 2.0."}
],
"max_tokens": 8192
}'
La respuesta está en choices[0].message.content y el recuento de tokens en usage. La misma solicitud con el SDK de OpenAI, el streaming, la entrada de imágenes y el formato nativo están en la guía de la Gemini 4 Carbon API. Para bucles de agentes y programación con contexto largo, consulta Gemini 4 Carbon API para agentes de programación.
Preguntas frecuentes
¿Cuál es el ID de modelo de la Gemini 4 Carbon API?
Usa gemini-4-carbon. Pásalo en "model" para /v1/chat/completions, o en la ruta de la URL para /v1beta/models/gemini-4-carbon:generateContent.
¿Cuánto cuesta la Gemini 4 Carbon API?
En PoYo: 1,60 $ de entrada, 8,00 $ de salida y 0,08 $ de lectura de caché por cada millón de tokens (320 / 1.600 / 16 créditos). Google cobra 2,00 $ / 10,00 $ / 0,10 $ hasta el 30 de noviembre de 2026 y 4,00 $ / 20,00 $ / 0,20 $ desde el 1 de diciembre de 2026.
¿La Gemini 4 Carbon API es compatible con el SDK de OpenAI?
Sí. Define base_url="https://api.poyo.ai/v1", usa tu clave de PoYo e indica model="gemini-4-carbon" en chat.completions.create.
¿Cuál es la ventana de contexto y la salida máxima de Gemini 4 Carbon?
1.048.576 tokens compartidos entre entrada y salida, con 65.536 tokens de salida por defecto. Las entradas pueden ser texto, imágenes, audio, vídeo y PDF; la salida es texto.
¿Hay un nivel gratuito para la Gemini 4 Carbon API?
La página de precios de Google indica que Gemini 4 Carbon no está disponible en el nivel gratuito. PoYo funciona con pago por uso mediante créditos.
¿Debo usar la Gemini 4 Carbon API o la Gemini 4 Argon API?
Mismo precio por token; Carbon gasta más tokens por tarea. Google recomienda Argon para la mayoría del trabajo de ingeniería de software y de conocimiento, y Carbon para las tareas más difíciles de horizonte largo, contexto largo y seguridad.