Документация API

Эмбеддинги

Создание векторов для поиска, RAG, кластеризации и ранжирования.

Скачать инструкцию для агента .md

Эмбеддинги превращают текст в числовые векторы. Храните вместе вектор, исходный текст, метаданные и id модели, чтобы при смене модели можно было пересчитать индекс.

Один текст или массив

bash
curl https://api.aigate.shop/v1/embeddings \  -H "Authorization: Bearer sk-your-api-key" \  -H "Content-Type: application/json" \  -d '{    "model": "qwen/qwen3-embedding-8b",    "input": ["First document", "Second document"],    "encoding_format": "float"  }'

Ответ

json
{  "object": "list",  "data": [    {      "object": "embedding",      "index": 0,      "embedding": [0.0123, -0.0042, 0.0311]    }  ],  "model": "qwen/qwen3-embedding-8b",  "usage": {    "prompt_tokens": 8,    "total_tokens": 8  }}

Практические заметки

  • Делите длинные документы на фрагменты.
  • Не смешивайте разные модели эмбеддингов в одном индексе, если не уверены, что размерность и распределение совпадают.
  • Пересчитывайте эмбеддинги при смене модели или размерности.
  • По возможности применяйте фильтры по метаданным до поиска по близости векторов.