Introducción
GPT 6.1 Terra lee capturas y documentos para convertir su contenido en borradores concretos o campos estructurados. Con Terra, identifica la región de la captura y los campos que necesitas; pide marcar los valores ilegibles como desconocidos.
| Campo | Valor |
|---|---|
| Entrada | Texto |
| Salida | Texto |
| Ventana de contexto | 1,050,000 tokens |
| Límite de max_tokens | 128,000 |
| Entradas | texto / imágenes |
Funciones y aspectos destacados
El GPT 6.1 más ligero para el trabajo diario
GPT 6.1 Terra lee capturas y documentos para convertir su contenido en borradores concretos o campos estructurados. Con Terra, identifica la región de la captura y los campos que necesitas; pide marcar los valores ilegibles como desconocidos.
Un ajuste none para turnos que no necesitan planificación
Terra acepta none, low, medium, high, xhigh y max; none sirve para una extracción directa. Terra parte de 4,096 tokens por respuesta y permite 128,000; con esfuerzo superior a none, el razonamiento también consume ese presupuesto.
Imágenes más grandes, leídas con más detalle
Terra admite 256 mensajes y 128 definiciones de herramientas, con un presupuesto de 37,000 tokens de entrada por imagen en este endpoint. Con Terra, identifica la región de la captura y los campos que necesitas; pide marcar los valores ilegibles como desconocidos.
La misma ventana de 1,050,000 tokens, con un tramo para prompts largos
El contexto de 1,050,000 tokens de Terra incluye documentos, conversación y respuesta; reserva hasta 128,000 tokens para la salida. Un conjunto de documentos para Terra con más de 272,000 tokens de entrada usa la tarifa larga en toda la solicitud, incluida la respuesta; consulta los precios antes de enviarlo.
Parámetros de la solicitud
| Parámetro | Obligatorio | Descripción |
|---|---|---|
messages | Sí | Envía a Terra la captura y las instrucciones de extracción en messages; conserva los identificadores de herramientas al continuar. mínimo 1 elementos · máximo 256 elementos |
max_tokens | No | Calcula |
reasoning_effort | No | Terra acepta none, low, medium, high, xhigh y max; none sirve para una extracción directa. |
stop | No | Terra acepta una cadena de parada o hasta cuatro; evita un marcador que pueda aparecer en un valor extraído. mínimo 1 caracteres · mínimo 1 elementos · máximo 4 elementos |
temperature | No | temperature de Terra se aplica con |
top_p | No | En Terra con |
tools | No | Describe las funciones de búsqueda o extracción que Terra puede proponer; tu aplicación realiza la ejecución. máximo 128 elementos |
parallel_tool_calls | No | Permite varias consultas independientes de Terra juntas cuando no necesites un resultado para formular otra. Valor predeterminado: |
tool_choice | No | Elige auto, none, required o una función específica para el flujo documental de Terra. |
response_format | No | Pide la estructura JSON de los campos de Terra y compruébala con tu esquema. |
Precios
Entrada $1 / Salida $5 por 1 millón de tokens; Prompts de más de 272K tokens: Entrada $2 / Salida $7.50
Casos de uso
Leer capturas y convertirlas en cambios
Con Terra, identifica la región de la captura y los campos que necesitas; pide marcar los valores ilegibles como desconocidos.
Extraer campos de documentos y formularios
Pasa un formulario escaneado o un documento largo y pide campos con nombre en una estructura JSON fija. Usa reasoning_effort none o low para una extracción directa y valida la salida en tu aplicación.
Redactar y reescribir con una voz coherente
Dale a Terra tus notas de estilo y unos cuantos ejemplos aprobados, y pide respuestas, resúmenes o textos de producto. Está pensado para una redacción clara y natural, y normalmente basta con un esfuerzo bajo.
Cierra el ciclo de las llamadas a herramientas
Pide la estructura JSON de los campos de Terra y compruébala con tu esquema.
Guía de prompts y consejos prácticos
Elige el esfuerzo según la tarea
Terra acepta none, low, medium, high, xhigh y max; none sirve para una extracción directa.
Indica al modelo la parte de la imagen
Añade la imagen como una parte
image_urly nombra la región, por ejemplo la tercera columna de la tabla. Mantén la instrucción en texto junto a la imagen y no confíes en letras pequeñas que la imagen no pueda resolver.Define
max_tokenspara la respuesta que esperasmax_tokensvale 4,096 por defecto y admite hasta 128,000, contando el razonamiento dentro. Una extracción corta necesita poco; un borrador largo con más esfuerzo necesita más. Transmite las respuestas largas en streaming y revisafinish_reason.Cierra el ciclo de las llamadas a herramientas
Si defines herramientas, devuelve cada resultado como un mensaje tool con el
tool_call_idcorrespondiente y conserva lostool_callsdel asistente en el historial. Valida los argumentos antes de actuar sobre ellos.
GPT 6.1 Terra
GPT 6.1 Terra lee capturas y documentos para convertir su contenido en borradores concretos o campos estructurados.
openai/gpt-6.1-terra/chat
Con Terra, identifica la región de la captura y los campos que necesitas; pide marcar los valores ilegibles como desconocidos.
Terra parte de 4,096 tokens por respuesta y permite 128,000; con esfuerzo superior a none, el razonamiento también consume ese presupuesto.
En una extracción con Terra, define funciones que tu aplicación pueda ejecutar y devuelve cada resultado con el tool_call_id original; aquí se admiten 128 definiciones. Las herramientas nativas de OpenAI usan Responses.
Un conjunto de documentos para Terra con más de 272,000 tokens de entrada usa la tarifa larga en toda la solicitud, incluida la respuesta; consulta los precios antes de enviarlo.
La lectura de imágenes y la escritura de GPT 6.1 Terra no implican respuestas NSFW sin restricciones; la aceptación del contenido depende de las reglas del modelo.
La lectura de imágenes y la escritura de GPT 6.1 Terra no implican respuestas NSFW sin restricciones; la aceptación del contenido depende de las reglas del modelo.
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": "openai/gpt-6.1-terra/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.