Archivos y lotes
Crear Lote
Crea un trabajo por lotes compatible con OpenAI a partir de un archivo de entrada subido.
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_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.
- Los endpoints admitidos para elementos de lote son
/v1/chat/completionsy/v1/embeddings. No se admite/v1/responses.
Solicitud
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_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",
"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
Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Encabezados
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