[ { "id": str, # Unique identifier for the vector "vector": List[float], # The vector data "contents": str | bytes, # Optional content (accepts both strings and bytes). Bytes are base64-encoded, strings are passed directly. All contents are encrypted before storage. "metadata": Dict # Optional key-value pairs for filtering and retrieval }, ...]
The contents field accepts both strings and bytes. Bytes are automatically base64-encoded before encryption, while strings are passed as-is. Contents are returned in their original format (string or bytes) when retrieved with get().
Option 2: Separate Arrays
Parameter
Type
Default
Description
ids
List[str]
-
List of unique vector identifiers
vectors
List[List[float]] or np.ndarray
-
Vector data as 2D array
metadata
List[Dict]
None
(Optional) List of metadata dictionaries, one per vector
contents
List[str | bytes]
None
(Optional) List of content values, one per vector. Bytes are base64-encoded, strings are passed directly. All contents are encrypted before storage
When np.ndarray is passed as vectors, they are automatically sent in an optimized binary format for better performance with large batches.