Subir Archivo

Descripción GeneralCopy Anchor Link

Este endpoint es parte de la API por 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.

Modos de archivo admitidosCopy Anchor Link

TokenLab trata /v1/files como tres modos explícitos:

• Archivos de lote: usa purpose=batch para /v1/batches.
• Archivos de imagen/referencia: usa purpose=user_data o purpose=vision para solicitudes de imagen basadas en archivos.
• Modo Anthropic Files API: añade anthropic-beta: files-api-2025-04-14 para almacenamiento de archivos nativo de Anthropic.

NotasCopy Anchor Link

• 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 por lotes.

curl -X POST "https://api.tokenlab.sh/v1/files" \
  -H "Authorization: Bearer sk-your-api-key" \
  -F "purpose=batch" \
  -F "file=@batch-input.jsonl;type=application/jsonl"

Solicitud / RespuestaCopy Anchor Link

Utilice el panel interactivo de OpenAPI arriba para el esquema exacto.

Consejos OperativosCopy Anchor Link

• 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.

Entradas de archivos de imagenCopy Anchor Link

La misma ruta /v1/files también puede subir archivos de imagen de referencia para /v1/images/edits.

• Usa purpose=user_data o purpose=vision.
• Incluye opcionalmente model para seleccionar el modelo de edición de imágenes; el valor predeterminado es gpt-image-2.
• El file_id devuelto se vincula a la configuración de edición de imágenes seleccionada y puede reutilizarse en images[].file_id.

Modo Anthropic Files APICopy Anchor Link

Esta misma ruta /v1/files también admite la ruta de Anthropic Files API.

• Añade el encabezado anthropic-beta: files-api-2025-04-14 para cambiar al modo Anthropic.
• En modo Anthropic, sube el archivo original directamente y no envíes purpose=batch.
• El file_id devuelto queda vinculado al mismo espacio de trabajo compatible con Anthropic y debe reutilizarse en las solicitudes /v1/messages.
• Si vas a referenciar ese archivo desde el contenido de un mensaje Anthropic, sigue usando los encabezados nativos de Anthropic (x-api-key, anthropic-version y, cuando haga falta, el beta header).

{
  "id": "file_abc123",
  "object": "file",
  "bytes": 32768,
  "created_at": 1706000000,
  "filename": "batch-input.jsonl",
  "purpose": "batch"
}

Campos importantesCopy Anchor Link