GPT-6.1 Terra: precios de la API, Codex y cuándo elegir Sol
Elige GPT-6.1 Terra para cambios de código acotados y tareas repetibles en aplicaciones, y reserva Sol o Astra para lo más difícil. Configura Codex o Responses API, compara resultados independientes y calcula los costes de tokens, caché, contexto largo, modos rápidos y recargas de OpenRouter.
Índice
Usa GPT-6.1 Terra para cambios de código acotados y tareas repetibles de control de aplicaciones con criterios de aceptación claros. Reserva GPT-6.1 Sol o GPT-6 Astra para depurar problemas de causa incierta y realizar cambios complejos en varias partes del proyecto. A fecha de 2026-10-27, las tarifas Standard de Terra son $1 por millón de tokens de entrada y $5 por millón de tokens de salida.
Estos precios de entrada y salida son la mitad de las tarifas Standard actuales de Sol. El coste por tarea completada también depende del razonamiento, los reintentos, las escrituras de caché y la longitud del contexto.
¿Cuándo conviene elegir Terra en lugar de Sol?
Elige Terra cuando resulte sencillo comprobar el resultado y barato corregir los errores. Una corrección localizada, una actualización de pruebas o una tarea repetible en una aplicación son buenos puntos de partida.
OpenAI informa de una mejora considerable en programación respecto a la generación anterior de Terra. Con el máximo esfuerzo de razonamiento, GPT-6.1 Terra obtiene 50.3% en Terminal-Bench 4.0, frente al 21.5% publicado para GPT-5.6 Terra. El anuncio de lanzamiento sigue recomendando Sol o Astra para las tareas de programación más complejas.
Los resultados independientes muestran por qué no basta con comparar el precio por token. A fecha de 2026-10-27, Artificial Analysis publica estos resultados de Codex:
| Modelo en Codex | Esfuerzo de razonamiento | Coding Agent Index v2.0 | Coste medio de API por tarea | Tiempo medio del agente |
|---|---|---|---|---|
| GPT-6.1 Terra | xhigh | 48 | $0.69 | 16.4 minutos |
| GPT-6.1 Terra | max | 48 | $1.24 | 26.1 minutos |
| GPT-6.1 Sol | max | 54 | $1.50 | 23.7 minutos |
| GPT-6 Astra | max | 55 | $7.04 | 24.8 minutos |
El índice combina tres pruebas comparativas con distintos métodos de puntuación. Sus puntos no equivalen a un porcentaje universal de tareas resueltas. La metodología calcula el coste de API a partir de los intentos, incluidas las lecturas y escrituras de caché aplicables.
En estas pruebas, Terra con max cuesta menos que Sol con max, pero tarda más y obtiene menos puntos. Terra con xhigh alcanza la misma puntuación redondeada que Terra con max por menos dinero. Prueba ese ajuste antes de asumir que max ofrece la mejor relación entre calidad y coste.
OpenAI afirma un coste por tarea unas nueve veces menor que Opus en Agents’ Last Exam, una evaluación de control de aplicaciones. La velocidad más de tres veces superior a Sol y Astra también corresponde a esa evaluación. Sus resultados no demuestran la misma ventaja en programación.
Para un error difícil en producción, empieza con Sol. Para trabajo repetitivo con una prueba fiable o un estado final visible, prueba Terra primero.
Cómo ejecutar GPT-6.1 Terra en Codex
Usa Codex CLI 0.159.0 o posterior y selecciona gpt-6.1-terra explícitamente. Las instrucciones oficiales de modelos indican tanto esa versión mínima como el comando de inicio.
A fecha de 2026-10-27, Terra está disponible en Work y Codex con los planes Plus, Pro, Business, Enterprise y Edu. La actualización oficial del producto incluye Business expresamente. Terra no está disponible en Chat.
El acceso de Enterprise depende de la disponibilidad en el espacio de trabajo y de los controles del administrador. Terra no admite la opción de residencia de inferencia en los Emiratos Árabes Unidos (UAE).
En macOS o Linux, abre el directorio de tu repositorio en Bash. El repositorio oficial de Codex documenta este instalador:
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version
codex login
codex login status
codex -m gpt-6.1-terraComprueba que la versión sea al menos 0.159.0. Completa el inicio de sesión en el navegador con una cuenta de ChatGPT que tenga acceso.
Dentro de la sesión, usa /status para comprobar el modelo activo. Usa /model para seleccionar un esfuerzo de razonamiento disponible. Ambos aparecen en la referencia de comandos de CLI.
Para comprobar el acceso, pide a Codex que identifique el comando de pruebas del repositorio y explique una prueba existente. Una respuesta completada verifica más que un inicio de sesión correcto.
Si Terra no está disponible, revisa la versión de CLI, los requisitos de la cuenta y los controles del espacio de trabajo. Comprueba también el proveedor en ~/.codex/config.toml y en los archivos .codex/config.toml de proyectos de confianza. La opción -m selecciona un modelo; no sustituye tu configuración del proveedor.
El inicio de sesión con ChatGPT usa el acceso de la suscripción. El inicio de sesión con una clave de API factura el uso a la cuenta de OpenAI Platform. Terra puede permitir completar más tareas con la misma cuota, pero los precios de API no determinan un número fijo de tareas incluidas.
Terra también admite el modo Fast de Codex, donde esté disponible, mediante /fast. Consume los límites incluidos en la suscripción a 2.5× Standard. Los créditos comprados y el uso de Enterprise de pago por consumo se cobran a 2× Standard.
Cómo llamar a Terra mediante Responses API
Usa Responses API para una aplicación o un agente. Terra exige esta interfaz para llamar a herramientas.
La referencia del modelo recoge estas especificaciones a fecha de 2026-10-27:
| Parámetro | Valor documentado |
|---|---|
| ID del modelo en la API | gpt-6.1-terra |
reasoning.effort | none, low, medium, high, xhigh, max |
| Razonamiento predeterminado en la API | medium |
| Ventana de contexto | 1,050,000 tokens |
| Salida máxima | 128,000 tokens |
| Fecha límite de conocimientos | 2026-06-01 |
| Entrada y salida | Texto e imágenes de entrada; texto de salida |
| Interfaz para llamar a herramientas | Responses API |
La especificación de contexto de la API no determina cuánto contexto puede usar Codex. Codex obtiene los límites y otros ajustes de su catálogo de modelos. Comprueba el contexto que muestra la sesión antes de planificar una tarea de programación con un millón de tokens.
Para comprobar la API directamente, necesitas una clave de OpenAI Platform, facturación de API habilitada, Bash, una versión actual de curl y jq. Pega la clave cuando read espere la entrada y pulsa Enter:
set -o pipefail
read -rs OPENAI_API_KEY && export OPENAI_API_KEY
curl --silent --show-error --fail-with-body \
https://api.openai.com/v1/responses \
--header "Authorization: Bearer ${OPENAI_API_KEY}" \
--header "Content-Type: application/json" \
--data '{
"model": "gpt-6.1-terra",
"reasoning": {"effort": "medium"},
"service_tier": "default",
"max_output_tokens": 4096,
"prompt_cache_options": {"mode": "explicit"},
"store": false,
"input": "Fix this Python function so empty input returns None, then provide two pytest tests: def first(xs): return xs[0]"
}' |
jq '{
id, model, status, service_tier,
text: ([.output[]? | select(.type == "message")
| .content[]? | select(.type == "output_text") | .text] | join("\n")),
usage, error, incomplete_details
}'El ejemplo sigue el formato de solicitud de Responses. El selector extrae el texto de los elementos de mensaje del array output.
Un resultado correcto tiene status igual a completed, código y pruebas en text, y recuentos de tokens en usage. La solicitud es síncrona, así que no necesita consultas periódicas de estado.
El ejemplo selecciona el procesamiento Standard explícitamente. También elige caché explícita sin puntos de corte, o breakpoints, lo que evita escrituras de caché en esta solicitud.
Si el resultado está incompleto, revisa incomplete_details. El límite de salida incluye tokens de razonamiento, por lo que un límite pequeño puede agotarse antes de terminar la respuesta. Para errores HTTP, consulta el código de error documentado. La autenticación, los créditos agotados y los límites de solicitudes requieren soluciones diferentes.
Para controlar aplicaciones, añade el entorno de ejecución descrito en la guía de computer use. Tu aplicación debe ejecutar las acciones permitidas y devolver capturas de pantalla actualizadas. La solicitud de texto anterior no controla un navegador ni un escritorio.
Cómo calcular el precio de la API de GPT-6.1 Terra
Calcula cada solicitud a partir de la entrada ordinaria, las lecturas de caché, las escrituras de caché y la salida facturada. Contar solo el texto visible subestima el consumo de un modelo con razonamiento.
Estos son los precios directos de OpenAI Standard en USD por millón de tokens, verificados el 2026-10-27:
| Categoría de tokens | Solicitudes con hasta 272,000 tokens de entrada | Solicitudes con más de 272,000 tokens de entrada |
|---|---|---|
| Entrada ordinaria | $1.00 | $2.00 |
| Lecturas de entrada en caché | $0.05 | $0.10 |
| Escrituras de caché, retención de 30 minutos | $1.25 | $2.50 |
| Escrituras de caché, retención de 12 horas | $2.50 | $5.00 |
| Salida | $5.00 | $7.50 |
Las reglas de precios del modelo aplican el ajuste por contexto largo a toda la solicitud. Las lecturas y escrituras de caché también reciben el multiplicador de entrada.
Considera esta estimación para una solicitud con 100,000 tokens de entrada ordinaria y 10,000 tokens de salida facturada:
(100,000 × $1.00 + 10,000 × $5.00) / 1,000,000 = $0.15
Con las tarifas de Sol de $2 para entrada y $10 para salida, el mismo volumen de tokens cuesta $0.30. La comparación supone recuentos idénticos; una tarea real de programación puede consumir cantidades diferentes.
Estos ejemplos suponen procesamiento Standard, sin recargo regional ni cargos adicionales por herramientas o alojamiento. Los impuestos y las comisiones del intermediario se calculan aparte. La salida facturada incluye tokens de razonamiento.
¿Qué ocurre al superar 272K tokens de entrada?
Superar 272,000 tokens de entrada cambia las tarifas de toda la solicitud. El aumento no se limita a los tokens que exceden el umbral.
Para una solicitud estimada con 300,000 tokens de entrada ordinaria y 10,000 tokens de salida facturada:
(300,000 × $2.00 + 10,000 × $7.50) / 1,000,000 = $0.675
La tarifa de entrada se duplica y la de salida aumenta un 50%. Comprueba cada solicitud por separado durante una sesión larga del agente. Una conversación acumulada puede superar el umbral aunque la última instrucción sea corta.
Conserva solo el contexto que necesita el siguiente paso. Compara los recuentos de tokens y la calidad del resultado antes de ampliar el contexto disponible.
¿Cómo se contabilizan las escrituras de caché?
Trata las escrituras de caché como una categoría de entrada independiente. Sus tarifas ya incluyen el procesamiento de esos tokens; no vuelvas a sumar el cargo de entrada ordinaria.
La guía de caché de prompts expone estos campos:
usage.input_tokens: entrada total.usage.input_tokens_details.cached_tokens: lecturas de caché facturadas.usage.input_tokens_details.cache_write_tokens: escrituras de caché facturadas.
La entrada ordinaria equivale a la entrada total menos las lecturas y las escrituras. Para distintos plazos de retención, usa cache_write_tokens_details.ttl_30m_tokens y ttl_12h_tokens.
El coste estimado de escribir 100,000 tokens en una caché de 30 minutos y generar 10,000 tokens de salida es:
(100,000 × $1.25 + 10,000 × $5.00) / 1,000,000 = $0.175
Una solicitud posterior con 100,000 tokens leídos de caché y la misma salida cuesta $0.055. Ese ahorro supone que el prefijo coincide y cumple las condiciones para reutilizarse.
Para contexto reutilizable, establece prompt_cache_options.ttl en "30m" o "12h". Si el contexto cambia y no volverá a usarse, los puntos de corte explícitos pueden evitar escrituras innecesarias.
¿Cuándo cambian la factura Batch, Flex y Fast?
Usa el procesamiento con descuento para trabajos que puedan tolerar demoras. Mantén Standard para la programación interactiva, salvo que una mayor velocidad justifique el recargo.
A fecha de 2026-10-27:
- Batch: los precios por token son un 50% inferiores a Standard. La Batch API usa trabajos asíncronos con una ventana de finalización de 24 horas.
- Flex: los precios por token son un 50% inferiores a Standard. Establece
service_tieren"flex"para obtener procesamiento más lento con posible falta de recursos. - Fast: los precios por token son 2× Standard. Establece
service_tieren"fast"y comprueba el nivel devuelto, como explica la guía de Fast.
El procesamiento regional añade un recargo del 10% donde está disponible. Estos cargos de API son independientes de los multiplicadores de la cuota de suscripción de Codex.
Cómo usar OpenRouter con su ID de modelo y sus comisiones
Usa OpenRouter cuando encaje con tu sistema de enrutamiento y facturación. La disponibilidad de Terra está verificada, pero su ID de modelo y su gestión del estado conversacional difieren de OpenAI directo.
A fecha de 2026-10-27, el catálogo de OpenRouter confirma la disponibilidad de Terra. Estas son las rutas y los identificadores:
| Ruta | ID del modelo | URL completa de Responses |
|---|---|---|
| OpenAI directo | gpt-6.1-terra | https://api.openai.com/v1/responses |
| OpenRouter | openai/gpt-6.1-terra | https://openrouter.ai/api/v1/responses |
Usa tu propia clave del proveedor seleccionado con autenticación Bearer. Para un cliente SDK de OpenRouter, la URL base es https://openrouter.ai/api/v1.
OpenRouter publica $1 para entrada, $5 para salida, $0.05 para lecturas de caché y $1.25 para escrituras, por millón de tokens. Su catálogo especifica tarifas superiores para más de 272,000 tokens de prompt: $2, $7.50, $0.10 y $2.50, respectivamente.
La interfaz Responses de OpenRouter funciona sin estado. Envía el historial de conversación en cada solicitud. Establecer store: true o un previous_response_id distinto de null devuelve HTTP 400.
Incluye la comisión de recarga al estimar cuánto dinero gastarás. OpenRouter Standard cobra un 5.5% cuando compras créditos. Las compras con tarjeta tienen una comisión mínima de $0.80.
Por ejemplo, comprar $100 de créditos Standard cuesta $105.50 antes de los impuestos aplicables. 100 solicitudes como la anterior de $0.15 consumen $15 en créditos del modelo. Si distribuyes la comisión de recarga proporcionalmente, obtienes:
100 × $0.15 × 1.055 = $15.825, aproximadamente $15.83.
Esta es una estimación del gasto monetario con la comisión distribuida. La comisión se paga al recargar la cuenta, no en cada solicitud. Una compra de $10 aplica el mínimo de $0.80, por lo que usar el mismo reparto del 5.5% sería incorrecto.
Antes de migrar un agente existente, revisa cómo gestiona el estado y qué herramientas necesita. Que una solicitud de texto sea compatible no demuestra la compatibilidad con todas las herramientas de su ciclo.
Asigna a Terra tareas con una comprobación de aceptación clara
Empieza trasladando a Terra un tipo de tarea acotada y mide el resultado completo. Conserva tu modelo actual para trabajos que exijan reinterpretar requisitos o integrar cambios repetidamente.
Ante una regresión de interfaz, deja que Sol defina el comportamiento incorrecto y el criterio de aceptación. Entrega a Terra el componente afectado, el comando de pruebas pertinente y el resultado visual esperado. Pide a Sol que revise el parche y resuelva los cambios que afecten a varios componentes.
Esta división es una recomendación de trabajo basada en los resultados de programación. Las pruebas citadas no evaluaron un coordinador Sol con subagentes Terra.
Mide el gasto total en inferencia de la primera tentativa, los reintentos y la revisión por el modelo. Divide ese gasto entre los resultados aceptados y registra por separado el tiempo de revisión humana. Anota también si la primera tentativa pasó las comprobaciones y cuánto duró la tarea completa.
Una tarifa de Terra más baja solo ayuda si mejoran esos totales. Si una tarea necesita repetidamente que Sol la resuelva después, asigna directamente ese tipo de tarea a Sol. Para el control repetible de aplicaciones, exige un estado final visible que tu aplicación pueda verificar antes de aceptar la tarea como completada.
