Skip to main content
POST
Python (SDK)

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

X-On-Behalf-Of
string

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

Parâmetros de caminho

vector_store_id
string
obrigatório

O ID do armazenamento de vetores para o qual criar um Lote de Arquivos.

Corpo

application/json

Corpo da solicitação para criar um lote de arquivos de armazenamento de vetores.

file_ids
string[]

Uma lista de IDs de arquivo que o vector store deve usar. Se attributes ou chunking_strategy forem fornecidos no nível raiz, eles serão aplicados a todos os arquivos no lote. Mutuamente exclusivo com 'files'. No máximo 500 por lote.

Maximum array length: 500
files
object[]

Uma lista de objetos que cada um inclui um file_id, além de atributos opcionais ou chunking_strategy. Use isto quando precisar substituir os metadados de arquivos específicos. Entradas sem seus próprios atributos ou chunking_strategy recorrem aos valores no nível da solicitação. Mutuamente exclusivo com 'file_ids'. No máximo 500 por lote.

Maximum array length: 500
attributes
object

Atributos padrão para todo o lote, aplicados a cada arquivo que não tenha os seus próprios (os atributos de uma entrada de 'files' substituem estes).

chunking_strategy
object

Estratégia de fragmentação padrão para todo o lote, aplicada a cada arquivo que não tenha sua própria (a estratégia de fragmentação de uma entrada de 'files' a substitui).

Resposta

200 - application/json

OK

Um lote de arquivos anexados a um armazenamento vetorial.

id
string
obrigatório

O identificador, que pode ser referenciado em endpoints de API.

object
any
obrigatório

O tipo de objeto, que é sempre 'vector_store.file_batch'.

created_at
integer
obrigatório

O timestamp Unix (em segundos) de quando o lote de arquivos do armazenamento de vetores foi criado.

Intervalo obrigatório: -9007199254740991 <= x <= 9007199254740991
vector_store_id
string
obrigatório

O ID do armazenamento de vetores ao qual o arquivo está anexado.

status
enum<string>
obrigatório

O status do lote de arquivos do vetor. 'em_andamento' significa que os arquivos estão sendo processados, 'concluído' significa que todos os arquivos foram processados, 'cancelado' significa que o lote foi cancelado, 'falhou' significa que o lote falhou.

Opções disponíveis:
in_progress,
completed,
cancelled,
failed
file_counts
object
obrigatório

Contagens de status de processamento de arquivos.