Archivos y lotes
Cargar archivo
Cargue un archivo por lotes, una referencia de imagen o un archivo en formato Anthropic.
Propósitos de los archivos
- Archivos por lotes (batch): utilice
purpose=batchpara/v1/batches. - Archivos de imagen/referencia: utilice
purpose=user_dataopurpose=visionpara solicitudes de imágenes respaldadas por archivos. - Archivos de Anthropic: añada el encabezado
anthropic-beta: files-api-2025-04-14.
Límites
| Propósito | Tamaño máximo |
|---|---|
batch | 200 MiB |
user_data, vision | 50 MiB |
| Archivos de Anthropic | 500 MB |
Un archivo más grande devuelve 413 request_too_large. Un purpose distinto a batch, user_data o vision devuelve 400 unsupported_purpose. Una solicitud sin file devuelve 400.
Un archivo batch caduca 24 horas después de su carga. Para cambiar esto, envíe los campos de formulario expires_after[anchor]=created_at y expires_after[seconds] desde 3600 hasta 2592000 (30 días). El campo expires_at de la respuesta muestra la hora.
Solicitud
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"Entradas de archivos de imagen
Esta misma ruta /v1/files puede cargar archivos de referencia de imagen para /v1/images/edits.
- Utilice
purpose=user_dataopurpose=vision. - Opcionalmente, incluya
modelpara seleccionar el modelo de edición de imágenes; el valor predeterminado esgpt-image-2. - El
file_iddevuelto está vinculado a la configuración de edición de imagen seleccionada y puede reutilizarse enimages[].file_id.
Modo API de archivos de Anthropic
- Añada
anthropic-beta: files-api-2025-04-14para utilizar los archivos de Anthropic. - En el modo Anthropic, cargue el archivo original directamente y no envíe
purpose=batch. - El
file_iddevuelto solo está disponible en el Workspace actual y puede reutilizarse en solicitudes a/v1/messages. - Si planea hacer referencia al archivo cargado desde el contenido de un mensaje de Anthropic, siga utilizando los encabezados nativos de Anthropic (
x-api-key,anthropic-versiony el encabezado beta cuando sea necesario).
Respuesta
{
"id": "file_abc123",
"object": "file",
"bytes": 32768,
"created_at": 1706000000,
"filename": "batch-input.jsonl",
"purpose": "batch"
}Campos importantes
batch, 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
Encabezados
Incluya files-api-2025-04-14 para usar el modo de API de Anthropic Files.
Cuerpo de la solicitud
multipart/form-data
Respuesta
application/json
application/json
application/json
application/json