hosting

POST `/v1/vector/indexes/{indexId}/query`

Find the nearest vectors.

Kimlik Doğrulama

Bearer token olarak bir API anahtarı gönderin. Anahtar vector.manage iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.

Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.

Dene

Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.

curl -X POST https://api.zinndigital.com/v1/vector/indexes/{indexId}/query \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "values": <number[]> }'

Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın

Ayrıntılar

Returns the top_k nearest vectors, nearest first, optionally restricted to those whose metadata contains filter. distance is in the index's own metric, so smaller is always nearer whichever metric you chose. ⛔ A query spends the plan's monthly query allowance, which is why it requires vector.manage rather than vector.view — a read that costs money is not a read.

Parametreler

Ad	Tür	Zorunlu	Ne olduğu
`indexId (path)`	`string`	Evet	The index's id.

İstek gövdesi

Ad	Tür	Zorunlu	Ne olduğu
`values`	`number[]`	Evet	The query vector — exactly `dimension` values.
`top_k`	`integer`	Hayır	—
`filter`	`object`	Hayır	Restrict the search to vectors whose metadata contains these keys and values. Containment, not equality of the whole object, so a filter naming one key matches a vector carrying…

Yanıt

Ad	Tür	Zorunlu	Ne olduğu
`matches`	`object[]`	Evet	—

Bu uç noktanın dönderebileceği hatalar

401 · 403 · 404 · 422 · 429

POST /v1/vector/indexes/{indexId}/query