Saltar al contenido principal
Sube un archivo de entrada de lotes como formulario multipart, guarda el id que devuelve y vuelve a leer los metadatos y los bytes del archivo con ese ID. Los ejemplos usan un client creado como en Instalación.

Sube un archivo

TypeScript y Python suben el archivo con un método del SDK, que envía POST /v1/batches/files. Los demás SDK no pueden enviar multipart, así que envían el formulario a POST /v1/files con el cliente HTTP estándar.

Opciones de subida

Se aplican a los métodos de subida de TypeScript y Python. En las solicitudes multipart directas, envía purpose y file como campos del formulario.

Vuelve a leer un archivo

Sustituye file_123 por el ID que devolvió la subida. En Python también puedes usarlas a través de client.files: create(params) sube el archivo igual que upload_file, list() lista, retrieve(id) lee los metadatos y content(id) lee los bytes. Rust no tiene métodos de archivos.
Los endpoints de archivos están en beta y necesitan un proveedor de lotes habilitado.

Guarda el ID del archivo: no puedes listar archivos

Guarda el id de cada archivo subido. Los métodos de listado llaman a GET /v1/files, que devuelve 400 con el código not_supported y el motivo file_list_not_supported_with_shared_gateway_key. El contrato completo está en la referencia de la API de archivos.

Respuesta

FileObject, de la subida y de los métodos de metadatos:
Última modificación el 5 de noviembre de 2026