#Создать эмбеддинги

POST /v1/embeddings

Преобразует текст в векторное представление. Векторы нужны для семантического поиска, кластеризации, поиска дублей и подбора похожих карточек CRM. Формат запроса и ответа совместим с OpenAI API, потоковой передачи нет.

Эмбеддинги умеют только модели, у которых в GET /v1/models поле capabilities.embeddings равно true.

#Поля запроса (body)

#Примеры

#curl — личный ключ

curl -X POST https://vibecode.bitrix24.tech/v1/embeddings \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/embeddings",
    "input": "Хотим CRM на 50 пользователей"
  }'

#curl — OAuth-приложение

curl -X POST https://vibecode.bitrix24.tech/v1/embeddings \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/embeddings",
    "input": "Хотим CRM на 50 пользователей"
  }'

#JavaScript — личный ключ

const res = await fetch('https://vibecode.bitrix24.tech/v1/embeddings', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bitrix/embeddings',
    input: ['Первый текст', 'Второй текст'],
  }),
})

const result = await res.json()
console.log(result.data.length)        // 2 — по вектору на строку
console.log(result.data[0].embedding)  // [0.0203, 0.0034, ...]

#JavaScript — OAuth-приложение

const res = await fetch('https://vibecode.bitrix24.tech/v1/embeddings', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bitrix/embeddings',
    input: ['Первый текст', 'Второй текст'],
  }),
})

const result = await res.json()

#Поля ответа

Ответ приходит в сыром OpenAI-формате, без обёртки success и data.

#Пример ответа

Показаны первые три значения вектора. Полная размерность зависит от модели — у bitrix/embeddings это 4096 значений.

{
  "object": "list",
  "model": "bitrix/embeddings",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [0.0203, 0.0034, -0.0156]
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 0,
    "total_tokens": 12
  }
}

#Пример ответа при ошибке

501 embeddings_unsupported — у модели нет поддержки эмбеддингов:

{
  "error": {
    "message": "Model \"bitrix/bitrixgpt-5.5\" does not support embeddings.",
    "type": "server_error",
    "code": "embeddings_unsupported"
  }
}

#Ошибки

Полный список общих ошибок API — Ошибки.

#Известные особенности

Коды ошибок приходят в нижнем регистре. Тело большинства ошибок — сырой OpenAI-формат { "error": { "message", "type", "code" } }, без поля success. Два исключения приходят в конверте { "success": false, "error": { … } }: отказы по квоте и темпу запросов (402 ai_quota_exhausted, 429 ai_pacing_limited) и непредвиденная ошибка сервера 5xx, у которой код записан в верхнем регистре. Обработчик должен принимать оба конверта.

Массив input сохраняет порядок. Вектор data[i] соответствует строке input[i], а поле data[].index дублирует эту позицию — по нему можно сопоставить результат после параллельной обработки.

Бюджет обработки запроса — около 850 секунд. По исчерпании бюджета приходит 503 ai_provider_timeout. Заголовка Retry-After в этом ответе нет намеренно: повтор того же запроса упрётся в тот же бюджет. Разбейте массив input на части меньшего размера.

Подсказка о пополнении в ответе 402 ai_quota_exhausted. Только в ветке reason: "wallet_empty" ответ может дополнительно нести строку hint с подсказкой и ссылку topupUrl на пополнение баланса. Оба поля появляются, когда на платформе включены принудительный контроль квоты и подсказка о пополнении, поэтому читайте их как необязательные. Поле hint в этом ответе — строка.

Расход считается только по входным токенам. Поле usage.completion_tokens всегда 0, поэтому платится только вход. Для модели bitrix/embeddings цена входа нулевая.

#Смотрите также

• Список моделей
• Создать чат-комплишен
• AI-квота компании
• AI Router