Core concepts
The four ideas you need to use Valori — project, collection, record, and search.
- Project
- The logical boundary for your Valori resources. Your API key identifies which project a request belongs to — you never pass a project ID explicitly.
- Collection
- A named set of vectors that share a fixed dimension and distance metric. Both are required at creation and immutable afterward.
- Record
- One stored vector inside a collection, with optional metadata and text. Insert and delete are the operations every project API key can reach.
- Search
- A k-nearest-neighbour query: given a vector, Valori returns the closest records in a collection under its metric.
Dimension and metric are fixed per collection
A collection's dimension and metric are set once, at creation, and
never change. Every vector you insert into that collection must match its
dimension exactly — there's no implicit conversion or padding.
Where to go deeper
- Collections in the API Reference — create, list, delete
- Search in the API Reference — query parameters and response shape