К содержимому
Разделы документации

Векторы

Пока не выкачено. POST /v1/embeddings: одна строка или пачка до 128, цена только за запрос, текст не хранится.

Пока не выкачено. Здесь — как посчитать векторы текста, когда метод откроют. Списание — только за токены запроса.

Запрос

Нужен ключ компании. Пробный ключ и ключ сессии этот метод не принимают, в том числе ключ сессии на балансе компании: ответ 403, баланс не списывается. Ключ передайте в заголовке Authorization: Bearer.

Положите ключ и ID модели в переменные. ID возьмите на странице Модели и цены.

bash
export KONDUCTOR_KEY="<ключ>"
export KONDUCTOR_MODEL="<ID модели>"

Одна строка:

bash
curl https://llm.kodzavod.ru/v1/embeddings \
  -H "Authorization: Bearer $KONDUCTOR_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF
{
  "model": "$KONDUCTOR_MODEL",
  "input": "Посчитай вектор этой строки"
}
EOF

Пачка из двух строк. В одном запросе можно отправить от 1 до 128 непустых строк:

bash
curl https://llm.kodzavod.ru/v1/embeddings \
  -H "Authorization: Bearer $KONDUCTOR_KEY" \
  -H "Content-Type: application/json" \
  -d @- <<EOF
{
  "model": "$KONDUCTOR_MODEL",
  "input": ["Первая строка", "Вторая строка"]
}
EOF

В ответе у каждой строки свой вектор в data: index с нуля, без пропусков. Сколько рублей списано за запрос, лежит в usage.cost_rub.

Что можно отправить

input — одна непустая строка или пачка из 1–128 непустых строк. Пустая строка, пустой элемент, не строка и пачка длиннее 128 — ответ 400, баланс не списывается. Массив токенов и объекты — тоже 400. Строка длиннее контекста модели — 400. Тело больше 8 МБ — 413.

Чат-модель этот метод не принимает: ответ 400. Неизвестная модель — тоже 400.

Цена

Списание одно, только за токены запроса. Цены ответа нет. Не хватает баланса — 402.

Что не хранится

Текст запроса не хранится. Вектор ответа не хранится. Текст уходит в OpenRouter и поставщику модели. Фильтр provider.data_collection deny ограничивает выбор поставщика по данным OpenRouter о его политике и не гарантирует нулевое хранение. Модель и цену запрос берёт из каталога цен. Условия хранения — в оферте.

Если запрос не прошёл

Коды 402, 403 и 429 разобраны на странице Ошибки 402, 403 и 429. Поля и ответы — в справочнике API.

Эта страница в Markdown для ИИ-ассистентов — embeddings.md. Для генераторов SDK — openapi.json. Изменения API — в журнале изменений.