Introducción
Envía texto e imágenes en el formato de chat de OpenAI y lee la respuesta, las llamadas a funciones o el JSON. El razonamiento ocurre antes del resultado y consume max_tokens, así que fija un límite muy superior a la extensión esperada.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Texto |
| Contexto compartido | 1,048,576 tokens |
| Límite de max_tokens | 65536 |
| Entradas | texto / imágenes |
Funciones y aspectos destacados
Reservado para los problemas difíciles
Google sitúa a Carbon por encima de Gemini 4 Argon en depuración de varios pasos e investigación abierta, aunque aclara que Argon sigue siendo adecuado para la mayor parte del trabajo diario de ingeniería.
Dedica tokens a comprobar su trabajo
Carbon usa más tokens para razonar y verificar que los modelos ligeros, así que espera una larga fase de trabajo interno antes de una respuesta breve.
Una sola ventana para todo el problema
Registros, archivos fuente y notas comparten un contexto de 1,048,576 tokens con el razonamiento y la respuesta.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
messages | Sí | La conversación con Carbon, del mensaje más antiguo al más reciente. Los mensajes de usuario pueden combinar partes de texto con partes |
max_tokens | No | Presupuesto de respuesta de Carbon, de 1 a 65536, con 4096 por defecto. |
reasoning_effort | No | Profundidad de razonamiento de Carbon: low, medium o high, con medium por defecto. El razonamiento no se puede desactivar, y high es el nivel que más tokens usa. |
stop | No | De una a cuatro cadenas de parada de hasta 32 caracteres cada una. La respuesta de Carbon termina antes de la primera coincidencia, que no se devuelve. mínimo 1 caracteres · mínimo 1 elementos · máximo 4 elementos |
temperature | No | Acepta valores de 0 a 2 para que los clientes de estilo OpenAI sigan funcionando. Según la documentación de Google, Carbon ignora este ajuste, así que la respuesta no cambia. |
top_p | No | Acepta valores de 0.01 a 1 para que los clientes de estilo OpenAI sigan funcionando. Según la documentación de Google, Carbon también ignora este ajuste. |
tools | No | Hasta 128 definiciones de funciones que Carbon puede solicitar. Tu aplicación valida los argumentos, ejecuta la función y devuelve el resultado en un mensaje tool. máximo 128 elementos |
parallel_tool_calls | No | Activado por defecto, así que Carbon puede solicitar varias funciones en un mismo turno. Usa false para recibir una sola llamada cada vez. Valor predeterminado: |
tool_choice | No | Define el siguiente paso de Carbon: auto, none, required o una función concreta. |
response_format | No | Pide a Carbon un objeto JSON, o JSON que siga un |
Precios
Entrada $2 / Salida $10 por 1 millón de tokens
Casos de uso
Rastrear un error entre varios servicios
Pega los registros con fallas y el código relacionado, y pide a Carbon que ordene las causas probables junto con la comprobación que descartaría cada una.
Poner a prueba un argumento científico
Entrega a Carbon una derivación o una sección de métodos y pregunta en qué punto el razonamiento depende de un supuesto no declarado.
Guía de prompts y consejos prácticos
Deja mucho margen en
max_tokensEl razonamiento usa el mismo presupuesto que la respuesta. En nuestra prueba, un límite de 400 tokens con una entrada larga gastó 397 tokens en razonar y no devolvió texto.
Reserva Carbon para lo que lo amerita
Envía las reescrituras y consultas rutinarias a un modelo más ligero, y recurre a Carbon cuando un error costaría tiempo de verdad.
Gemini 4 Carbon es el modelo de razonamiento más potente de Google para depuración difícil, investigación y ejecuciones largas de agentes.
google/gemini-4-carbon/chat — /v1/chat/completions
Ajusta reasoning_effort a low, medium o high; Carbon empieza en medium. El razonamiento consume max_tokens antes de que aparezca texto visible.
Si el límite se agota durante el razonamiento, la llamada termina con finish_reason length y una respuesta vacía.
Los mensajes de usuario pueden incluir partes image_url. Carbon también puede solicitar las funciones que declares en tools y devolver JSON mediante response_format.
Los sistemas de seguridad de Google revisan las solicitudes a Carbon, por lo que algunas indicaciones pueden rechazarse.
Inicio rápido de la API
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "google/gemini-4-carbon/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
Consulta la referencia de la API para autenticación, el esquema completo, sondeo y gestión de errores.













