OpenAI: GPT-4.1 (batch)
OpenAI GPT-4.1 es un modelo sin una etapa dedicada de razonamiento para seguir instrucciones precisas, programar y llamar a herramientas. Acepta texto e imágenes y devuelve texto, con una amplia ventana de contexto, Structured Outputs y Predicted Outputs para regenerar texto o código que permanece casi sin cambios.
Sobre el modelo
Esta descripción cubre las capacidades del modelo. Las entradas, salidas y opciones disponibles en Ailoot se indican a continuación para el método seleccionado.
GPT-4.1 es el modelo de OpenAI sin una etapa dedicada de razonamiento para seguir instrucciones y llamar a herramientas, con amplios conocimientos en distintos ámbitos. Acepta texto e imágenes y devuelve texto sin un paso específico de razonamiento. Su contexto amplio resulta útil cuando la tarea está claramente definida, pero el material pertinente abarca documentos o código extensos. Indica la operación que deseas, el material de origen al que se aplica y la forma del resultado final.
Para procesar documentos, separa las instrucciones del material mediante encabezados u otros límites claros. Etiqueta los documentos y conserva los identificadores que la respuesta deba citar. Define los campos para una extracción, los criterios para una comparación o el público y la longitud de una reescritura. Un ejemplo de salida puede ser una tabla de requisitos con sus ubicaciones en las fuentes, un resumen organizado según un conjunto concreto de preguntas o un registro estructurado que distinga la información ausente de un valor explícito.
Para programar, proporciona los archivos pertinentes, el cambio solicitado y el comportamiento que debe mantenerse intacto. Pide el resultado real que necesitas: una función revisada, un archivo completo, argumentos propuestos para herramientas o una explicación de la lógica afectada. Los ejemplos pueden aclarar una regla de formato o un caso límite, pero deben seguir los mismos requisitos que la tarea real. Las recomendaciones de OpenAI para redactar instrucciones destacan las instrucciones directas, los roles, los límites de las fuentes y los ejemplos representativos, en lugar de suponer que unas instrucciones largas son automáticamente precisas.
Las especificaciones exactas de GPT-4.1 indican una ventana de contexto de 1,047,576 tokens, una salida máxima de 32,768 tokens y conocimientos actualizados hasta el 1 de junio de 2024. Un contexto de entrada amplio no implica una salida igual de amplia, por lo que una solicitud para reescribir material extenso debe identificar la parte y el resultado final necesarios. Deja espacio suficiente para la respuesta y proporciona información actual cuando la tarea dependa de hechos posteriores a la fecha límite de los conocimientos. El tipo de modelo documentado de GPT-4.1 es chat; los ajustes de esfuerzo de razonamiento de modelos de razonamiento posteriores no forman parte de este perfil.
OpenAI documenta las interfaces Chat Completions, Responses, Assistants, Batch y ajuste fino para GPT-4.1. Las funciones enumeradas incluyen transmisión en flujo, Structured Outputs, llamadas a funciones, carga de archivos, entrada de imágenes, búsqueda en la web y en archivos, ajuste fino y almacenamiento de la entrada en caché. Sus herramientas incluyen interpretación de código, generación de imágenes y conexiones MCP, además de búsqueda y funciones. La salida del propio modelo es texto, mientras que una herramienta puede devolver un resultado u observación independientes. Define el propósito y los argumentos de una operación de la aplicación y utiliza el resultado real devuelto; una solicitud generada por el modelo no confirma que una operación externa se haya completado.
Una característica distintiva es Predicted Outputs en la interfaz Chat Completions de OpenAI. Cuando ya se conoce la mayor parte del resultado de texto o código deseado, el contenido existente puede proporcionarse como predicción para ayudar a regenerar el resultado completo con un pequeño cambio. Por ejemplo, proporciona un archivo actual y pide un cambio de nombre de una propiedad definido de forma precisa, conservando el código circundante. La predicción es contenido de salida esperado, no una instrucción ni una garantía de que las partes sin cambios sigan siendo correctas. Examina el resultado regenerado frente a la modificación solicitada y el material original.
Predicted Outputs tiene sus propios límites de compatibilidad. OpenAI documenta su uso solo con texto, sin entradas ni salidas de audio y sin llamadas a funciones en esa solicitud. No admite múltiples opciones con n mayor que 1, logaritmos de las probabilidades, penalizaciones positivas de presencia o frecuencia ni el parámetro max_completion_tokens. Mantén este proceso de regeneración separado de una tarea que necesite llamadas a herramientas. El texto de predicción puede coincidir con partes de la salida, y el proveedor informa de los tokens de predicción aceptados y rechazados; una predicción inadecuada puede quedar parcialmente sin utilizar, por lo que la función no garantiza una aceleración ni un resultado concretos.
Para tareas habituales de seguimiento de instrucciones, un resultado útil de GPT-4.1 es un documento o código que cumpla unas especificaciones definidas, una extracción con campos explícitos o una solicitud de herramienta cuyos argumentos encajen con la operación proporcionada. Para un pequeño cambio en un archivo que permanece casi sin modificaciones, el proceso de salida predicha ofrece una forma más concreta de preparar el resultado esperado. En ambos casos, conserva el material de origen necesario para comprobar la respuesta y explicita las ambigüedades. La capacidad de contexto y las herramientas del modelo respaldan el proceso; las indicaciones de la tarea siguen determinando qué contiene una respuesta completa y utilizable.
Ailoot Ultra · Batch POST /v1/batches openai/gpt-4.1:batch
openai/gpt-4.1:batchInicio
OpenAI GPT-4.1 es un modelo sin una etapa dedicada de razonamiento para seguir instrucciones precisas, programar y llamar a herramientas. Acepta texto e imágenes y devuelve texto, con una amplia ventana de contexto, Structured Outputs y Predicted Outputs para regenerar texto o código que permanece casi sin cambios.
- Entradas aceptadas
- Texto
- Resultados
- Texto
Disponible en Ailoot · entradas y métodos
Ailoot Ultra · Batch POST /v1/batches
- Entrada
text- Salida
text- Formato de salida
- JSON de results[].response.body en línea
| Campo | Tipo | Requisito | Valores y límites | Predeterminado |
|---|---|---|---|---|
Campoendpoint | Tipostring | RequisitoObligatorio | Valores y límites /v1/chat/completions | Predeterminado— |
Campomodel | Tipostring | RequisitoObligatorio | Valores y límites openai/gpt-4.1:batch | Predeterminado— |
Camporequests | Tipobatch_item[] | RequisitoObligatorio | Valores y límites Número mínimo de elementos: 1 | Predeterminado— |
Camporequests[].custom_id | Tipostring | RequisitoObligatorio | Valores y límites | Predeterminado— |
Camporequests[].body.messages | Tipomessage[] | RequisitoObligatorio | Valores y límites | Predeterminado— |
Campocompletion_window | Tipostring | RequisitoOpcional | Valores y límites 24h | Predeterminado— |
Campoprovider | Tipoobject|null | RequisitoOpcional | Valores y límites | Predeterminado— |
Camporequests[].body.model | Tipostring | RequisitoOpcional | Valores y límites openai/gpt-4.1:batch, openai/gpt-4.1 | Predeterminado— |
Campoprovider.only | Tipostring[] | RequisitoOpcional | Valores y límites openai | Predeterminado— |
Campoprovider.allow_fallbacks | Tipoboolean|null | RequisitoOpcional | Valores y límites false, null | Predeterminado— |
Parámetros del método y ciclo de vida
| Parámetro | Contrato |
|---|---|
Parámetrocontent_type | Contratoapplication/json |
Parámetrorequired | Contratoendpoint, model, requests |
Parámetromaterial_types | Contratotext |
Parámetrorepresentation | Contratorequests[] en línea; cada elemento tiene custom_id y body |
Parámetrorequest_endpoint_profile | Contrato/v1/chat/completions |
Parámetrofile_material | ContratoQuien realiza la llamada puede leer localmente el JSONL UTF-8 real e incorporarlo a requests[]. No se utiliza el campo purpose para cargas, ni input_file_id ni referencias a archivos. Si falta el material del cliente o está vacío, la preparación se detiene antes del POST. |
Parámetroserialization_order | Contratoendpoint, model, provider (si se proporciona), completion_window (si se proporciona), requests al final |
Parámetrooptional_controls | Contratoprovider.only, provider.allow_fallbacks, completion_window |
Parámetroschema_scope | ContratoCuerpos de solicitudes de texto de Chat Completions dentro de la estructura Batch en línea documentada. |
Ciclo de vida: asynchronous
GET /v1/batches/{operation_id} · El response.id real de la respuesta de creación original; el mismo usuario, clave y grupo
Tarifas
Las referencias tarifarias no añaden opciones a la solicitud. Los parámetros admitidos se indican en el método seleccionado.
- Modo fast
- Sin especificar Cuando se selecciona el modo fast
- Modo flex
- Sin especificar Cuando se selecciona el modo flex
- Esfuerzo máximo de razonamiento
- Sin especificar Cuando el esfuerzo máximo de razonamiento usa el ajuste default
- Precios de caché explícita
- No habilitado Cuando se solicita caché explícita
Tarifas de Ailoot
Precios por configuración
Relaciona cada cargo con las condiciones mostradas. Usa una tarifa para cada conjunto de configuraciones alternativas.
| Configuración | Tabla de tarifas | Tokens de contexto, más de | Tokens de contexto, hasta inclusive | Cargo |
|---|---|---|---|---|
| ConfiguraciónTarifas base por token | Tabla de tarifasTarifa base | Tokens de contexto, más de— | Tokens de contexto, hasta inclusiveSin límite superior | Cargo Entrada · Tokens de entrada $0.002 / 1K tokens Salida · Tokens de salida $0.008 / 1K tokens Entrada · Lectura de caché $0.0005 / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
| ConfiguraciónNivel 1 por longitud de la solicitud | Tabla de tarifas— | Tokens de contexto, más de0 | Tokens de contexto, hasta inclusiveSin límite superior | Cargo Entrada · Tokens de entrada $0.002 / 1K tokens Salida · Tokens de salida $0.008 / 1K tokens Entrada · Lectura de caché $0.0005 / 1K tokens Entrada · Escritura en caché — / 1K tokens Entrada · Escritura en caché, 1 hora — / 1K tokens |
Ailoot reserva un monto estimado antes de la solicitud. Tras obtener el resultado, liquida el cargo definitivo según el uso medido. En las respuestas en flujo, la liquidación usa el registro de uso final. Cómo funcionan la reserva y la liquidación →
Solicitudes de ejemplo
Ailoot Ultra · Batch
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"openai/gpt-4.1:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen
def prepare_requests(customer_path):
path = Path(customer_path)
if not path.is_file(): raise ValueError("Customer JSONL file is missing")
items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
if not items: raise ValueError("Customer JSONL contains no requests")
ids = set()
for item in items:
if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
cid = item["custom_id"]
if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
ids.add(cid)
if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
supplied_model = item["body"].get("model")
if supplied_model is not None and supplied_model not in ['openai/gpt-4.1:batch', 'openai/gpt-4.1']: raise ValueError("body.model must be an exact documented caller or wire ID")
return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-4.1:batch", "requests":items}
if __name__ == "__main__":
material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
body = prepare_requests(material)
key = os.environ.get("AILOOT_API_KEY", "")
if not key: raise SystemExit("Set AILOOT_API_KEY")
request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
with urlopen(request) as response:
raw = response.read()
Path("batch-create-response.json").write_bytes(raw)
print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.
Recibir y guardar resultados
Ailoot Ultra · Batch
JSON de results[].response.body en línea
GET /v1/batches/{operation_id}
Consultar el estado de la tarea
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
Conserva todos los resultados completados
Conserva todas las respuestas, archivos y partes de contenido completos recibidos.
Conserva el JSON completo del estado original, cada result/custom_id y el cuerpo completo de la respuesta o del error. Guarda results[] completados como JSONL sin filtrar.
Si es necesario revisar la respuesta original
Conserva el ID de la operación original. La respuesta 503 result_pending_check incluye X-Should-Retry:false; nunca vuelvas a enviar un lote original cuyo resultado sea desconocido.
Campos de respuesta
| Campo | Tipo |
|---|---|
Camporesults[].custom_id | Tipostring |
Camporesults[].response.body.choices[].message.content | Tipostring|null |
Camporesults[].error | Tipoobject|null |
Campousage | Tipoobject|null |
Campoid | Tipostring |
Campomodel | Tipostring |
Campoendpoint | Tipostring |
Campostatus | Tipostring |
Camporequest_counts | Tipoobject |
Camporesults[].id | Tipostring |
Camporesults[].response.status_code | Tipointeger |
Camporesults[].response.request_id | Tipostring |
Errores y siguientes pasos
| Respuesta | Condición | Siguiente paso |
|---|---|---|
Respuesta400 · invalid_request_error | CondiciónLa estructura en línea documentada no es válida, hay claves duplicadas, existe un problema con la identidad de los elementos o hay un conflicto entre las capacidades configuradas del modelo. | Siguiente pasoCorrige los campos indicados antes de realizar cualquier nuevo envío. |
Respuesta401 · authentication_error | CondiciónClave de API no válida. | Siguiente pasoUsa la clave de Ailoot autorizada. |
Respuesta403 · permission_error | CondiciónGrupo de Batch no disponible. | Siguiente pasoVerifica los permisos de la clave y el grupo. |
Respuesta422 · invalid_request_error | CondiciónBatch usa facturación contra saldo; se rechazan las solicitudes de creación con una suscripción. | Siguiente pasoUsa el grupo autorizado con facturación contra saldo. |
Respuesta422 · price_unavailable | CondiciónNo se puede cotizar la entrada de Batch. | Siguiente pasoConserva la respuesta; usa la entrada documentada para la familia. |
Respuesta402 · billing_error | CondiciónReserva de Batch no disponible. | Siguiente pasoResuelve los requisitos de admisión antes de realizar una nueva solicitud. |
Respuesta503 · price_unavailable | CondiciónPrecio del método Batch o tarifas nativas no disponibles. | Siguiente pasoConserva la respuesta; no sustituyas los precios. |
Respuesta503 · api_error | CondiciónLa ruta exacta del proveedor no está disponible. | Siguiente pasoConserva la respuesta para reparar la ruta. |
Respuesta503 · result_pending_check | CondiciónEl resultado original requiere una revisión; X-Should-Retry:false. | Siguiente pasoConserva el operation_id/id original y consulta su estado; nunca repitas el POST original. |
Respuesta404 · not_found | CondiciónLa operación de consulta de estado de Batch no existe o pertenece a otra identidad. | Siguiente pasoUsa el id original exacto y el mismo usuario, clave y grupo. |
Alias
Alias del modelo
Ailoot Ultra openai/gpt-4.1:batch
Alias de rutas de métodos
Usa las rutas de método indicadas arriba.
ID de modelo relacionados
FAQ · OpenAI: GPT-4.1 (batch)
- ¿Qué entradas y resultados están disponibles?
POST /v1/batches·openai/gpt-4.1:batch:text→text- ¿Qué campos utiliza la solicitud?
POST /v1/batches·openai/gpt-4.1:batch:endpoint,model,requests,completion_window,provider- ¿Qué límites se aplican?
POST /v1/batches·openai/gpt-4.1:batch:requests.min_items:1