cicora.ai
Русский
Спецификация APIEmbeddings

Embeddings

Преобразуйте текст или поддерживаемые входы в векторы для поиска, кластеризации и рекомендаций.

Справочник интеграции: выбирайте параметры и доступные возможности из API-настроек аккаунта и каталога модели для своего окружения.

Создайте векторы

Поле input принимает один элемент или пакет. Сохраняйте позицию каждого входа: индекс ответа должен сопоставляться с вашим исходным документом.

Не смешивайте в одном индексе векторы, полученные разными моделями или размерностями, без явного плана миграции.

Embedding request
bash
curl --request POST https://cicora.ai/api/v1/embeddings \
  --header "Authorization: Bearer $CICORA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "openai/text-embedding-3-small",
    "input": ["First support note", "Second support note"],
    "encoding_format": "float"
  }'

Индексирование

  • Нормализуйте текст одинаково при индексации и поиске.
  • Храните model id и размерность вместе с каждым индексом.
  • Разбивайте длинные документы на осмысленные фрагменты до эмбеддинга.

Поиск и оценка

Используйте косинусную близость или метрику, которой требует ваш векторный движок, затем при необходимости применяйте rerank к небольшой выборке.

Регулярно проверяйте качество на реальных запросах. Высокая численная близость не гарантирует полезный ответ пользователю.

Дальше