Archivos y lotes

Recuperar Lote

Recupera el estado actual, los conteos y los archivos de resultados para un lote.

GET
/v1/batches/{batch_id}

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_window es actualmente 24h.
  • El orden de salida no está garantizado; siempre coincida por custom_id.
  • La transmisión no es compatible dentro de los elementos del lote.

Ejemplo

Solicitud

cURL
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_id para la reconciliación idempotente en downstream.
  • Espere output_file_id y error_file_id solo después de que el trabajador finalice el lote.

Ejemplo de respuesta

Respuesta

200 OK
{
  "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