Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
vector_stores
/
{vector_store_id}
/
files
Python (SDK)
from openapi import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.llm.vector_stores.create_file(vector_store_id="vs_abc123", file_id="file-abc123", attributes={
        "category": "manual",
        "version": "2.0",
    })

    # Handle response
    print(res)
{
  "id": "file-abc123",
  "object": "vector_store.file",
  "usage_bytes": 0,
  "created_at": 1704067200,
  "vector_store_id": "vs_abc123",
  "status": "in_progress",
  "last_error": null,
  "chunking_strategy": {
    "type": "auto"
  },
  "attributes": {
    "category": "manual",
    "version": "2.0"
  }
}

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

Parámetros de ruta

​
vector_store_id
string
requerido

La ID de la tienda de vectores para la cual crear un archivo.

Cuerpo

application/json

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

​
file_id
string
requerido

Un ID de archivo que la tienda de vectores debe usar. Útil para herramientas como file_search que pueden acceder a archivos.

​
attributes
object

Conjunto de 16 pares clave-valor que se pueden adjuntar a un objeto. Las claves son cadenas con una longitud máxima de 64 caracteres. Los valores son cadenas con una longitud máxima de 512 caracteres, booleanos o números.

​
chunking_strategy
object

La estrategia de fragmentación utilizada para fragmentar el(los) archivo(s). Si no se establece, se utilizará la estrategia automática.

Respuesta

200 - application/json

Está bien

Una lista de archivos adjuntos a un almacén vectorial.

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

​
usage_bytes
integer
requerido

El uso total de la tienda de vectores en bytes. Tenga en cuenta que esto puede ser diferente del tamaño del archivo original.

Rango requerido: -9007199254740991 <= x <= 9007199254740991
​
created_at
integer
requerido

La marca de tiempo de Unix (en segundos) para cuando se creó el archivo de la tienda de vectores.

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

El ID de la tienda de vectores a la que está adjunto el archivo.

​
status
enum<string>
requerido

El estado del archivo de la tienda de vectores. 'en_progreso' significa que se está procesando actualmente, 'completado' indica que el archivo está listo para su uso, 'cancelado' significa que el procesamiento fue cancelado, 'fallido' significa que ocurrió un error.

Opciones disponibles:
in_progress,
completed,
cancelled,
failed
​
last_error
object
requerido

El último error asociado con este archivo de almacenamiento de vectores. Será nulo si no hay errores.

​
chunking_strategy
object

La estrategia utilizada para dividir el archivo.

​
attributes
object

Conjunto de 16 pares clave-valor que se pueden adjuntar a un objeto. Las claves son cadenas con una longitud máxima de 64 caracteres. Los valores son cadenas con una longitud máxima de 512 caracteres, booleanos o números.