hosting

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

Find the nearest vectors.

Аутентификација

Пошаљите API кључ као bearer токен. Кључ мора имати дозволу vector.manage; кључ без ње се одбија уз 403, а не 404.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

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[]> }'

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли

Детаљи

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.

Параметри

Назив	Тип	Обавезно	Шта је ово
`indexId (path)`	`string`	Да	The index's id.

Тело захтева

Назив	Тип	Обавезно	Шта је ово
`values`	`number[]`	Да	The query vector — exactly `dimension` values.
`top_k`	`integer`	Не	—
`filter`	`object`	Не	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…

Одговор

Назив	Тип	Обавезно	Шта је ово
`matches`	`object[]`	Да	—

Грешке које ова крајња тачка може вратити

401 · 403 · 404 · 422 · 429

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