Skip to main content
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

vector_store_id
string
requerido

El ID del almacén de vectores para el cual crear un lote de archivos.

Cuerpo

application/json

Cuerpo de la solicitud para crear un lote de archivo de almacenamiento de vectores.

file_ids
string[]

Una lista de IDs de archivo que el almacén vectorial debe usar. Si se proporcionan attributes o chunking_strategy en el nivel raíz, se aplicarán a todos los archivos del lote. Mutuamente excluyente con 'files'. Como máximo 500 por lote.

Maximum array length: 500
files
object[]

Una lista de objetos que cada uno incluye un file_id más atributos opcionales o chunking_strategy. Use esto cuando necesite anular los metadatos de archivos específicos. Las entradas sin sus propios atributos o chunking_strategy recurren a los valores a nivel de la solicitud. Mutuamente excluyente con 'file_ids'. Como máximo 500 por lote.

Maximum array length: 500
attributes
object

Atributos predeterminados para todo el lote, aplicados a cada archivo que no tenga los suyos propios (los atributos de una entrada de «files» los anulan).

chunking_strategy
object

Estrategia de segmentación predeterminada para todo el lote, aplicada a todos los archivos que no tengan la suya propia (la estrategia de segmentación de una entrada de «files» la anula).

Respuesta

200 - application/json

Está bien

Un lote de archivos adjuntos a un almacén de vectores.

id
string
requerido

El identificador, que se puede referenciar en los puntos finales de la API.

object
any
requerido

El tipo de objeto, que siempre es 'vector_store.file_batch'.

created_at
integer
requerido

La marca de tiempo de Unix (en segundos) para cuando se creó el lote de archivos del almacén de vectores.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
vector_store_id
string
requerido

La ID del almacén de vectores al que está adjunto el archivo.

status
enum<string>
requerido

El estado de los archivos del lote de la tienda de vectores. 'en_progreso' significa que los archivos están siendo procesados, 'completado' significa que todos los archivos han sido procesados, 'cancelado' significa que el lote fue cancelado, 'fallido' significa que el lote falló.

Opciones disponibles:
in_progress,
completed,
cancelled,
failed
file_counts
object
requerido

Conteos de estado de procesamiento de archivos.