Archivos y lotes
Recuperar Lote
Recupera el estado actual, los conteos y los archivos de resultados para un lote.
Descripción General
Este endpoint es parte de la API de Lote compatible con OpenAI de TokenLab. Los trabajos por lotes utilizan archivos JSONL cargados, se ejecutan de manera asíncrona y pueden devolver archivos de salida/error más tarde.
Notas
- Los archivos de entrada del lote deben usar
purpose=batch. completion_windowes actualmente24h.- El orden de salida no está garantizado; siempre coincida por
custom_id. - La transmisión no es compatible dentro de los elementos del lote.
Solicitud
curl -X GET "https://api.tokenlab.sh/v1/batches/batch_abc123" \
-H "Authorization: Bearer sk-your-api-key"Solicitud / Respuesta
Utilice el panel interactivo de OpenAPI arriba para el esquema exacto.
Consejos Operativos
- Use
custom_idpara la reconciliación idempotente en downstream. - Espere
output_file_idyerror_file_idsolo después de que el trabajador finalice el lote.
Respuesta
{
"id": "batch_abc123",
"object": "batch",
"status": "completed",
"input_file_id": "file_abc123",
"output_file_id": "file_out123",
"error_file_id": "file_err123",
"request_counts": { "total": 100, "completed": 98, "failed": 2 }
}Campos importantes
request_countsobject
Recuentos de solicitudes totales, completadas, fallidas y canceladas.
output_file_idstring|null
Identificador de archivo usado por APIs relacionadas.
error_file_idstring|null
Identificador de archivo usado por APIs relacionadas.
Autorización
BearerAuth AuthorizationBearer <token>
Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
batch_id*string
Respuesta
application/json
application/json