API turbopuffer - Conare

Conare espone l’API di turbopuffer su https://api.conare.ai/tpuf: mantieni il tuo codice e l’SDK turbopuffer, e puntali a Conare con una chiave Conare.

curl https://api.conare.ai/tpuf/v2/namespaces/products/query \
  -H "Authorization: Bearer $CONARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rank_by": ["vector", "ANN", [0.1, 0.2, 0.3, 0.4]], "top_k": 10}'

import os
import turbopuffer

tpuf = turbopuffer.Turbopuffer(
    api_key=os.environ["CONARE_API_KEY"],
    region="gcp-us-central1",  # any value: Conare ignores it
    base_url="https://api.conare.ai/tpuf/{region}",
)

ns = tpuf.namespace("products")
ns.write(
    upsert_rows=[{"id": 1, "vector": [0.1, 0.2, 0.3, 0.4], "title": "refunds"}],
    distance_metric="cosine_distance",
)
result = ns.query(rank_by=("vector", "ANN", [0.1, 0.2, 0.3, 0.4]), top_k=10)

Response

{
  "billing": { "billable_logical_bytes_queried": 0, "billable_logical_bytes_returned": 0 },
  "performance": { "cache_hit_ratio": 1.0, "cache_temperature": "hot", "query_execution_ms": 0, "server_total_ms": 0 },
  "rows": [{ "$dist": 0.0, "id": 1 }]
}

Fornisci i tuoi vettori, e questi namespace sono separati da quelli del resto dell’API.

Supportato

Area	Supportato
Scritture	Upsert, patch, eliminazioni, scritture condizionali, eliminazione o patch per filtro
Query	Vettoriali (ANN ed esatte), full-text BM25, ordinamento per attributo, filtri, aggregazione `Count`, fino a 16 query in una chiamata
Namespace	Elenco, schema, metadati, riscaldamento della cache, eliminazione, copia e branch
Distanza	`cosine_distance`, `euclidean_squared`
`top_k`	Fino a 10.000

Qualsiasi altra cosa, come group_by o più colonne vettoriali, restituisce 400 con un messaggio che la indica.

Limiti

Limite
Query	1.000 al secondo per organizzazione
Scritture, altre chiamate	100 al secondo ciascuna
Body della richiesta	Fino a 64 MiB