Saltar al contenido principal
POST
/
api
/
v1
/
llm
/
vector_stores
/
{vector_store_id}
/
files
Python (SDK)
from mka1 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>.

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 almacenamiento vectorial para el cual crear un archivo.

Cuerpo

application/json

Cuerpo de la solicitud para crear un archivo de almacén de vectores.

​
file_id
string
requerido

Un ID de archivo que el almacén 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 agrupamiento utilizada para agrupar 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 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'.

​
usage_bytes
integer
requerido

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

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 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 del archivo del almacén de vectores. 'en_proceso' 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.