Construye con CometAPI¿Necesitas una sola API para varios modelos?Prueba el flujo en el Playground y luego crea una clave de API cuando el modelo y el costo encajen con tu caso de uso.
GPT-6.1 Terra (gpt-6.1-terra) es el modelo de nivel medio de la familia GPT-6.1 de OpenAI lanzado el 26 de octubre de 2026. Ofrece sólido razonamiento visual, uso preciso de la computadora y redacción natural a mitad de precio que GPT-6.1 Sol y GPT-5.6 Terra ($1 por entrada / $5 por salida por millón de tokens estándar). Con una ventana de contexto de 1.05M tokens, esfuerzo de razonamiento configurable (de none a max), entrada de imagen y soporte completo de herramientas mediante la Responses API, es ideal para flujos de trabajo con alto volumen de agentes, como procesamiento de facturas, interpretación de planos técnicos, interacción con pantallas y revisión de documentos. Esta guía cubre la configuración exacta, ejemplos de código, estrategias de razonamiento, buenas prácticas, comparativas y cómo acceder de forma más rentable a través de CometAPI.
Puntos clave
ID del modelo: gpt-6.1-terra — ventana de contexto de 1,050,000, 128,000 tokens máximos de salida, fecha de corte de conocimientos 1 de junio de 2026.
Precios (estándar OpenAI): $1 / $5 por 1M de tokens de entrada/salida; entrada en caché $0.05; contexto largo (>272K de entrada) y Fast mode cuestan más.
Revisado para mayor claridad, atribución de fuentes y terminología API actual.
Mejor para tareas visuales + uso de computadora; supera significativamente a GPT-5.6 Terra mientras iguala o se acerca a modelos de nivel superior a un costo mucho menor y mayor velocidad.
Preferir la Responses API para llamadas a herramientas, uso de computadora, salidas estructuradas y control del razonamiento.
CometAPI ofrece el mismo modelo con tarifas con descuento (alrededor de $0.80 / $4.00) con una única clave compatible con OpenAI para 500+ modelos, permitiendo cambios fáciles y ahorros continuos del 20–40%.
¿Qué es GPT-6.1 Terra?
GPT-6.1 Terra es el modelo rápido y eficiente de nivel medio en la familia GPT-6.1, posicionado entre el ligero Luna y los más capaces Sol/Astra. El posicionamiento oficial enfatiza el razonamiento visual detallado, el uso preciso de la computadora (interacción con pantalla, llenado de formularios, control de aplicaciones) y una redacción natural más clara.
Acepta entradas de texto e imagen y produce salida de texto. No soporta de forma nativa entrada/salida de audio o video. Las capacidades clave incluyen streaming, salidas estructuradas, function calling, caché de prompts, búsqueda web, búsqueda en archivos, computer use, code interpreter y más—principalmente a través de la Responses API.
OpenAI destaca importantes mejoras sobre GPT-5.6 Terra: puntuaciones más altas en Agents’ Last Exam (tareas profesionales de uso de computadora) a aproximadamente un tercio del costo, casi paridad con GPT-6 Astra en algunos benchmarks visuales y de agentes a ~1/10 del precio por token, tasas de alucinación sustancialmente más bajas y más de 3× mayor velocidad de finalización de tareas que Sol o Astra en cargas de trabajo relevantes.
Especificaciones y precios de GPT-6.1 Terra
Especificación
Detalles
Model ID
gpt-6.1-terra
Context Window
1,050,000 tokens
Max Input Tokens
~922,000
Max Output Tokens
128,000
Knowledge Cutoff
June 1, 2026
Input Modalities
Text, Image
Output Modalities
Text
Reasoning Effort Levels
none, low, medium (default), high, xhigh, max
Supported Endpoints
Chat Completions, Responses, Batch
Tool Calling
Requires Responses API
Fine-tuning
No compatible
Precio estándar de OpenAI (por 1M de tokens)
Entrada: $1.00
Entrada en caché: $0.05
Escrituras en caché (retención de 30 min): $1.25
Salida: $5.00
Notas: Los prompts que superen 272K tokens de entrada incurren en tarifas 2× de entrada/caché y 1.5× de salida para toda la solicitud. Batch/Flex son 50% más bajos; Fast mode es 2×. El procesamiento regional puede añadir recargos.
CometAPI actualmente muestra GPT-6.1 Terra aproximadamente a $0.80 de entrada / $4.00 de salida (confirmar en el panel), ofreciendo ahorros significativos y un endpoint unificado compatible con OpenAI.
Cómo configurar la API de GPT-6.1 Terra
Directo con OpenAI
Crea o usa un proyecto de OpenAI con acceso a la API (nivel Build en adelante; el nivel Free no es compatible con este modelo).
Genera una clave de API y guárdala de forma segura (variable de entorno o gestor de secretos).
Instala el SDK más reciente de OpenAI: pip install --upgrade openai (Python) o npm install openai (Node.js).
A través de CometAPI (recomendado para la mayoría de los usos en producción y multimodelo)
¿Cómo acceder a la API GPT-6.1 Terra en CometAPI?
Cuenta y credenciales
Inicia sesión en CometAPI, genera una clave de API y confirma que gpt-6.1-terra está disponible. Guarda la credencial como una variable de entorno, no en el código fuente de tu aplicación.
Una clave de CometAPI autentica las solicitudes a CometAPI. Mantenla en tu entorno de desarrollo o backend; no la insertes en una página web pública ni la subas al control de versiones. La variable de entorno debe estar disponible en la terminal que ejecuta tu script.
Set the key in Bash.
export COMETAPI_KEY="your_cometapi_api_key"
En Windows, define la misma variable en PowerShell.
$env:COMETAPI_KEY="your_cometapi_api_key"
Una primera solicitud pequeña y específica
Usa un prompt de texto corto y una respuesta antes de añadir datos de imagen, un esquema JSON o funciones. Confirma el acceso al modelo y la URL base https://api.cometapi.com/v1. Si tu cuenta ofrece múltiples rutas, elige la que cuya documentación cubra las funciones que planeas utilizar.
¿Cómo usar una respuesta de la API GPT-6.1 Terra?
Envía la primera solicitud de texto
Añade el siguiente código tras la configuración del cliente y guarda el script combinado como first_request.py. Solicita una respuesta corta, verifica la finalización y escribe el texto en un archivo UTF-8.
Genera una respuesta de texto, verifica la finalización y guarda answer.txt.
from pathlib import Path
response = client.responses.create(
model="gpt-6.1-terra",
instructions="You are a concise technical writing assistant.",
input="Summarize three common causes of failed API integrations and their fixes.",
reasoning={"effort": "medium"},
max_output_tokens=2000,
)
if response.status != "completed":
raise RuntimeError(
f"Response status: {response.status}; "f"details: {response.incomplete_details}"
)
ifnot response.output_text.strip():
raise RuntimeError("No text returned; inspect response.output")
Path("answer.txt").write_text(response.output_text, encoding="utf-8")
print(response.output_text)
print("Saved answer.txt")
print(response.usage)
Run the combined client-and-request script.
python first_request.py
Comprueba la respuesta guardada
Abre answer.txt y confirma que la respuesta aborda el prompt y contiene las tres causas y soluciones solicitadas. Una respuesta de API completada establece que la generación terminó; tu aplicación aún debe verificar si el contenido cumple sus requisitos. Conserva el registro de uso devuelto si vas a comparar costos de solicitudes.
Usa cURL para una comprobación HTTP directa
Para una comprobación rápida del endpoint sin el SDK, ejecuta este comando en Bash con COMETAPI_KEY definido. Inspecciona el JSON devuelto, incluido el estado, la salida y el uso. No asumas que el primer elemento de salida siempre contiene el texto final.
curl -sS https://api.cometapi.com/v1/responses \
-H "Authorization: Bearer $COMETAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-6.1-terra","input":"Explain how AI can reduce invoice-processing errors in 100 words.","reasoning":{"effort":"medium"},"max_output_tokens":600}'
Elige la configuración de la solicitud
Usa los Responses request fields a continuación como referencia compacta. Empieza con model, input y un presupuesto de salida moderado; añade formato o herramientas solo cuando el flujo de trabajo lo necesite.
Parámetro
Uso en este tutorial
model
Selecciona gpt-6.1-terra.
input
Pasa un prompt, mensajes, imágenes o elementos de conversación.
instructions
Define el comportamiento y los requisitos de salida.
reasoning.effort
Elige none, low, medium (default), high, xhigh o max.
max_output_tokens
Limita el presupuesto combinado de razonamiento y salida visible.
stream
Recibe eventos de forma incremental.
text.format
Solicita un formato de salida estructurado.
tools
Declara funciones invocables.
Elige low para una tarea simple de extracción o empieza con medium para análisis de documentos. Aumenta el esfuerzo cuando tus propios ejemplos muestren una mejora útil. Bajo las reglas de compatibilidad de parámetros de GPT-6, omite temperature, top_p y top_logprobs cuando effort no sea none.
Los tokens de razonamiento cuentan para el presupuesto de salida. Si la respuesta está incompleta, inspecciona su status y incomplete_details antes de analizarla o mostrarla. La guía de tokens de razonamiento explica por qué un valor pequeño de max_output_tokens puede consumirse antes de que se devuelva una respuesta visible completa.
Control del esfuerzo de razonamiento
Elige el esfuerzo de forma deliberada para equilibrar calidad, latencia y costo:
none: El más rápido, para extracción/clasificación simple.
low: Tareas rutinarias.
medium (predeterminado): La mayoría del trabajo mixto o de múltiples pasos.
high / xhigh / max: Discrepancias visuales complejas, planificación o tareas de alto impacto—úsalo solo cuando las evaluaciones justifiquen los tokens/latencia adicionales.
Chat Completions funciona para texto/imagen puro sin herramientas, pero la llamada a herramientas y algunas funciones avanzadas requieren Responses.
¿Cómo puede la API GPT-6.1 Terra analizar imágenes?
El modelo acepta imágenes junto con texto. Esto soporta interpretación de capturas de pantalla, extracción de documentos, revisión de planos técnicos y comparación de materiales visuales. La documentación de entrada de visión de OpenAI especifica el bloque de contenido input_image.
Analiza una imagen de factura local con Python
Coloca invoice.png en el directorio de trabajo.
Codifica un PNG local y envíalo con un prompt de extracción de factura. Terra destaca en coincidencia de fotos de producto, planos técnicos, capturas de pantalla y QA visual.
response = client.responses.create(
model="gpt-6.1-terra",
reasoning={"effort": "medium"},
input=[{
"role": "user",
"content": [
{"type": "input_text", "text": "Review this campaign image. List only visible issues with cropping, text placement, contrast, and logo safety. Cite regions and propose fixes."},
{"type": "input_image", "image_url": "https://example.com/image.jpg", "detail": "high"}
]
}]
)
print(response.output_text)
Los formatos compatibles incluyen PNG, JPEG, WEBP y GIF no animado. Usa detail: "high" o "low" según corresponda; mayor detalle consume más tokens. También se admiten URLs de datos Base64.
Llamada a herramientas, uso de computadora y salidas estructuradas
La llamada a herramientas (function calling, computer use, web search, file search, code interpreter, MCP, etc.) requiere la Responses API.
Buenas prácticas para computer use:
Ejecuta en un entorno aislado (navegador/VM).
Aplica listas de permitidos estrictas para sitios/acciones.
Requiere aprobación humana para acciones de alto impacto (compras, eliminaciones, exportación de datos).
Define límites de pasos/tiempo/costo.
Verifica el estado final en lugar de confiar solo en el resumen del modelo.
Trata el contenido de la página como no confiable (se afirma una fuerte resistencia a prompt-injection, pero la defensa en profundidad es esencial).
¿Debes usar Responses o Chat Completions?
Para GPT-6.1 Terra, Chat Completions admite solicitudes ordinarias de texto e imagen sin herramientas. La llamada a herramientas requiere Responses, que también se recomienda para flujos de agentes de múltiples pasos, gestión del estado de la conversación, preservación del contexto de razonamiento a través de llamadas a herramientas y eventos avanzados de streaming. Usa Responses para los ejemplos siguientes y para flujos que dependan de su salida estructurada o funciones de gestión de estado. Un gateway compatible también debe soportar el endpoint y los campos que envías. Consulta la guía oficial de migración.
Al mover una integración existente, verifica tres cosas antes de cambiar el tráfico: el ID del modelo, el endpoint y tus parámetros de solicitud. Una solicitud de Chat Completions con herramientas necesita una implementación en Responses; cambiar solo el nombre del modelo no basta. En Responses, usa reasoning.effort; en Chat Completions, usa reasoning_effort.
Tabla comparativa: GPT-6.1 Terra vs. modelos relacionados
Aspecto
GPT-6.1 Terra
GPT-6.1 Sol
GPT-5.6 Terra
GPT-6 Astra (aprox.)
Posicionamiento
Intermedio, alto volumen visual/uso de PC
Mayor capacidad
Intermedio previo
Frontier
Precio estándar (in/out)
$1 / $5
~$2 / $10
~$2 / $12
Mucho más alto
Contexto
1.05M
Similar
Similar
Similar
Velocidad en tareas de agentes
El más rápido del grupo
Más lento
Más lento
Más lento
Agents’ Last Exam
Fuerte (+15 pts vs 5.6 en medium)
Más fuerte en coding difícil
Base
Comparable o ligeramente mejor
Mejor uso
Agentes de alto volumen, QA visual, formularios
Coding/razonamiento complejo
Legado
Máxima capacidad
Gestión de errores en un flujo de la API de GPT-6.1 Terra
Primero separa una solicitud que necesita corrección de un fallo temporal de conexión o servicio. Comienza desde la solicitud funcional más pequeña al diagnosticar parámetros opcionales, y conserva los detalles de error en logs del servidor sin incluir la clave de API.
Fallo de autenticación o acceso: verifica la clave, el host de destino, el acceso de la cuenta y el saldo disponible antes de reintentar.
Parámetro no compatible: elimina campos opcionales, confirma el endpoint y el modelo, y añade un campo a la vez.
Generación incompleta: inspecciona status e incomplete_details; ajusta el presupuesto de salida o simplifica la tarea antes de consumir el resultado.
Límite de tasa o fallo transitorio: usa reintentos con backoff acotado y un límite de intentos. Reintentar puede generar otra respuesta facturable.
Stream interrumpido: conserva el texto parcial como salida interrumpida. No lo trates como respuesta completa ni ejecutes una acción basada en una solicitud de herramienta parcial.
Fallo de herramienta o de un sistema downstream: revisa la respuesta guardada y los registros de operaciones antes de repetir una actividad de negocio
Conclusión
GPT-6.1 Terra representa un avance práctico para desarrolladores que construyen agentes visuales y de uso de computadora de alto volumen. Su combinación de capacidad mejorada, eficiencia de costos notablemente mejor y razonamiento configurable lo convierte en la opción por defecto para muchas cargas de producción que antes requerían modelos más caros.
Comienza con la Responses API, inicia con esfuerzo de razonamiento medium, aplica salidas estructuradas y medidas de seguridad, y enruta el tráfico mediante una plataforma unificada como CometAPI para optimizar costos y flexibilidad. Con la configuración y patrones aquí descritos, puedes pasar de cero a una integración lista para producción en minutos manteniendo los costos controlados a largo plazo.
Para los precios, límites de tasa y disponibilidad de funciones más recientes, verifica siempre la documentación oficial de OpenAI y tu panel de CometAPI. ¡Feliz construcción!
Preguntas frecuentes
¿Pueden varios usuarios compartir una conversación de la API GPT-6.1 Terra?
Mantén el historial de conversación aislado por usuario o espacio de trabajo autorizado. Un backend compartido puede tener la credencial de la API, pero eso no da permiso a todos los usuarios para leer todas las conversaciones. Antes de cargar mensajes previos o resultados almacenados, verifica que el usuario actual pueda acceder a esa conversación. Para flujos colaborativos, define quién puede ver y ampliar el historial compartido.
¿El mismo prompt de la API GPT-6.1 Terra devolverá texto idéntico?
No confíes en salidas idénticas byte a byte en generaciones repetidas. Conserva el prompt, el ID del modelo, la configuración y el resultado aceptado cuando la reproducibilidad sea importante. Si un flujo necesita exactamente la misma redacción aprobada más tarde, recupera la respuesta guardada en lugar de generarla de nuevo. Evalúa una nueva respuesta frente a los requisitos de la tarea en lugar de tratar las diferencias de redacción por sí solas como un fallo.
¿store=False define la política de privacidad de todo el flujo de la API?
No. Un ajuste de almacenamiento a nivel de solicitud no describe cada log, caché o política de retención en tu aplicación y gateway de API. Revisa los términos y controles de datos que aplican a cada servicio antes de enviar documentos confidenciales. Limita los datos que envías y evita registrar contenido sensible del prompt en los logs de la aplicación solo para facilitar la depuración.
¿Cómo obtengo una clave de API de GPT-6.1 Terra?
Puedes acceder a la GPT-6.1 Terra API a través de CometAPI. Crea una cuenta, genera una clave de API y configura tu SDK con la URL base https://api.cometapi.com/v1 y el ID de modelo gpt-6.1-terra. No se requiere una clave de OpenAI por separado.
¿Cuánto cuesta la API GPT-6.1 Terra?
A 28 de octubre de 2026, los precios oficiales de OpenAI son $1.00 por millón de tokens de entrada, $0.05 por millón de tokens de entrada en caché y $5.00 por millón de tokens de salida. Las tarifas publicadas de CometAPI son $0.80 para entrada y $4.00 para salida, aproximadamente un 20% más bajas. Para 10,000 tokens de entrada sin caché y 2,000 tokens de salida, el costo estimado es $0.016 a través de CometAPI frente a $0.020 a través de OpenAI, sin cargos adicionales.
¿La API GPT-6.1 Terra es gratuita?
No. Según la documentación del modelo de OpenAI, GPT-6.1 Terra no está disponible en el nivel Free de la API y es accesible desde el nivel de pago Build en adelante. Los usuarios de ChatGPT Plus, Pro, Enterprise y Edu pueden acceder a Terra a través de ChatGPT Work y Codex, pero el uso de la API se factura por separado de las suscripciones de ChatGPT. Alternativamente, los desarrolladores pueden acceder a GPT-6.1 Terra a través de CometAPI con una clave de API válida y créditos suficientes, sujeto a la disponibilidad del proveedor.
