Archivos y lotes

Recuperar contenido del archivo

Descarga el contenido original de un archivo subido.

GET
/v1/files/{file_id}/content

Resumen

Este endpoint sirve principalmente a la recuperación de contenido de archivos de la API Batch compatible con OpenAI de TokenLab.

Cuando la solicitud entra en modo de compatibilidad con Anthropic Files, la misma ruta también puede hacer proxy del contenido original almacenado del archivo para el workspace enlazado.

Sin encabezados Anthropic, esta ruta descarga contenido de archivos de lote o proxifica contenido de un archivo de imagen/referencia vinculado cuando el proveedor lo permite.

Notas

  • Los archivos de entrada del lote deben usar purpose=batch.
  • completion_window es actualmente 24h.
  • El orden de salida no está garantizado; siempre empareja por custom_id.
  • No se admite streaming dentro de elementos del lote.

Ejemplo

Solicitud

cURL
curl -X GET "https://api.tokenlab.sh/v1/files/file_abc123/content" \
  -H "Authorization: Bearer sk-your-api-key" \
  --output batch-output.jsonl

Solicitud / Respuesta

Usa el panel OpenAPI interactivo de arriba para ver el esquema exacto.

Consejos operativos

  • Usa custom_id para reconciliación descendente idempotente.
  • Espera output_file_id y error_file_id solo después de que el worker finalice el lote.

Tipos de contenido

El contenido de archivos batch se devuelve como JSONL o texto plano. El contenido de referencias de imagen creadas por TokenLab puede enviarse como contenido binario cuando el proveedor de archivos subyacente admite la recuperación de contenido.

Ejemplo de respuesta

Respuesta

200 OK
{"custom_id":"request-1","response":{"status_code":200,"body":{"id":"chatcmpl_abc123"}}}
{"custom_id":"request-2","error":{"code":"invalid_request_error","message":"Invalid model"}}

Campos importantes

bodybinary|string
Contenido del archivo. Guárdalo o analízalo según Content-Type; analiza JSONL línea por línea.
custom_idstring
ID que relaciona un elemento de entrada del lote con su resultado.

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

file_id*string

Respuesta

text/plain

application/json