Archivos y lotes
Recuperar archivo
Recupera los metadatos de un único archivo subido.
Resumen
Este endpoint sirve principalmente a los objetos de archivo de la API Batch compatible con OpenAI de TokenLab.
Cuando la solicitud entra en el modo de compatibilidad con Anthropic Files, la misma ruta también puede devolver metadatos de archivos estilo Anthropic para el workspace enlazado.
Sin encabezados Anthropic, esta ruta puede devolver un objeto de archivo de lote o un objeto de archivo de imagen/referencia de TokenLab.
Notas
- Los archivos de entrada del lote deben usar
purpose=batch. completion_windowes actualmente24h.- El orden de salida no está garantizado; siempre empareja por
custom_id. - No se admite streaming dentro de elementos del lote.
Solicitud
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123" \
-H "Authorization: Bearer sk-your-api-key"Solicitud / Respuesta
Usa el panel OpenAPI interactivo de arriba para ver el esquema exacto.
Consejos operativos
- Usa
custom_idpara reconciliación descendente idempotente. - Espera
output_file_idyerror_file_idsolo después de que el worker finalice el lote.
Archivos de referencia de imagen
Este endpoint también puede devolver metadatos de archivos de referencia de imagen creados por TokenLab. El campo status es opcional y puede no estar presente en familias de archivos que no lo proporcionen.
Respuesta
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Campos importantes
batch, batch_output, user_data o vision.Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
Encabezados
Incluya files-api-2025-04-14 para usar el modo de API de Anthropic Files.
Respuesta
application/json
application/json