Векторизация текста

POST/v1/embeddings

Требуемое право: embeddings. Неизвестные поля и неподдерживаемые формы отклоняются до резервирования. Совместимость ограничена этой схемой.

Авторизация

Authorizationstringобязательный

Ключ API в заголовке Authorization: Bearer <ключ>. Ключ создаётся в кабинете, подробнее — в разделе Аутентификация.

Заголовки

Idempotency-Keystringобязательныйдлина 1–200

Один стабильный ключ на логический запрос. Повторяйте с тем же телом и тем же credential/endpoint. Новый ключ создаёт новый запрос.

Тело запроса

application/json · обязательное

modelstringобязательныйдлина 1–200

inputstring | string[]обязательный

Вложенные поля

Один из вариантов

Вариант 1

encoding_formatstringпо умолчанию "float"

Значения: "float" "base64"

dimensionsinteger1 … 2048

Ответы

200Успешный ответ

application/json

object"list"обязательный

modelstringобязательный

dataobject[]обязательный

Вложенные поля

object"embedding"обязательный

indexintegerобязательный0 … 9007199254740991

embeddingnumber[] | stringобязательный

Вложенные поля

Один из вариантов

Вариант 1

usageobjectобязательный

billingobject

Вложенные поля

statusstring

estimated_cost_microrubinteger0 … 9007199254740991

cost_microrubinteger | null

idstring

202Исход уточняется; резерв сохраняется

application/json

Обработка или сверка ещё не завершена. Сохраняйте исходный Idempotency-Key и тело. Резерв удерживается. Не создавайте новый запрос взамен этого.

Тип: object

ОшибкаОшибка проверки, прав, лимита или доступности. Код error.code; результат запроса при неизвестном исходе не следует считать отменённым.

application/json

errorobjectобязательный

Вложенные поля

codestringобязательный

messagestringобязательный

request_idstring

typestring

curl --request POST \ --url "https://api.kvantora.ai/v1/embeddings" \ --header "Authorization: Bearer $KVANTORA_API_KEY" \ --header "Idempotency-Key: $REQUEST_ID" \ --header "Content-Type: application/json" \ --data '{ "model": "<public_api_id>", "input": "Привет" }'

import os import requests response = requests.post( "https://api.kvantora.ai/v1/embeddings", headers={ "Authorization": f"Bearer {os.environ['KVANTORA_API_KEY']}", "Idempotency-Key": os.environ["REQUEST_ID"], }, json={ "model": "<public_api_id>", "input": "Привет", }, timeout=120, ) print(response.json())

const response = await fetch('https://api.kvantora.ai/v1/embeddings', { method: 'POST', headers: { Authorization: `Bearer ${process.env.KVANTORA_API_KEY}`, 'Idempotency-Key': process.env.REQUEST_ID, 'Content-Type': 'application/json', }, body: JSON.stringify({ "model": "<public_api_id>", "input": "Привет" }), }); console.log(await response.json());

{ "object": "list", "model": "<public_api_id>", "data": [ { "object": "embedding", "index": 0, "embedding": [ 0 ] } ], "usage": {}, "billing": { "status": "<string>", "estimated_cost_microrub": 0, "cost_microrub": 0 }, "id": "<string>" }