Archivos y lotes

Crear Lote

Crea un trabajo por lotes compatible con OpenAI a partir de un archivo de entrada subido.

POST
/v1/batches

Descripción General

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.
  • Los endpoints admitidos para elementos de lote son /v1/chat/completions y /v1/embeddings. No se admite /v1/responses.

Ejemplo

Solicitud

cURL
curl -X POST "https://api.tokenlab.sh/v1/batches" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "input_file_id": "file_abc123",
    "endpoint": "/v1/chat/completions",
    "completion_window": "24h"
  }'

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",
  "endpoint": "/v1/chat/completions",
  "input_file_id": "file_abc123",
  "completion_window": "24h",
  "status": "validating",
  "output_file_id": null,
  "error_file_id": null,
  "created_at": 1706000000
}

Campos importantes

idstring
Identificador para llamadas posteriores y soporte.
statusstring
Estado actual del ciclo de vida de este recurso.
output_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

Encabezados

X-TokenLab-Delivery-Policy?string

Política de entrega por solicitud. Sustituye los valores predeterminados de la API key y del Workspace. Auto intenta primero con TokenLab Verified y puede cambiar una vez a Official solo antes de la salida, la aceptación de la solicitud o la creación de recursos persistentes.

Valores permitidos

  • "auto"
  • "verified"
  • "official"

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json

application/json

application/json

application/json