Archivos y lotes

Listar Lotes

Lista trabajos por lotes para la organización de la clave API actual.

GET
/v1/batches

Resumen

Este endpoint es parte de la API de Lotes compatible con OpenAI de TokenLab. Los trabajos por lotes utilizan archivos JSONL subidos, se ejecutan de manera asíncrona y pueden devolver archivos de salida/error más tarde.

Notas

  • Los archivos de entrada por lotes 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?limit=20" \
  -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
{
  "object": "list",
  "data": [{ "id": "batch_abc123", "object": "batch", "status": "completed" }],
  "first_id": "batch_abc123",
  "last_id": "batch_abc123",
  "has_more": false
}

Campos importantes

objectstring
Tipo de objeto de la respuesta.
dataarray
Lista o payload devuelto por esta respuesta.
statusstring
Estado actual del ciclo de vida de este recurso.
has_moreboolean
Hay más resultados cuando has_more es true.

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 consulta

limit?integer
Rango1 <= value <= 100
after?string

Respuesta

application/json

application/json