---
title: "Создать эмбеддинги"
method: POST
path: "/v1/embeddings"
tags: ["Embeddings"]
---

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

`POST /v1/embeddings`

## Request

- Base URL: `https://api.hubris.pw`
- URL: `https://api.hubris.pw/v1/embeddings`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hubris.pw/oauth/authorize`, token URL `https://api.hubris.pw/oauth/token`, scopes: `chat:write`)

OpenAI-совместимый embeddings endpoint. Превращает текст в вектор фиксированной длины — для семантического поиска, RAG, классификации.

Принимает строку, массив строк (батч до 2048), массив токен-ID или массив массивов токен-ID. Биллинг — только по `prompt_tokens` (output всегда 0).

Стрима нет. Полный список embedding-моделей: `GET /v1/models` с фильтром `output_modalities=embeddings`.

## Request body

- EmbeddingsRequest
  - `model` string, required: ID embedding-модели — например, `openai/text-embedding-3-small`. Полный список: GET /v1/models, отфильтруйте по `output_modalities` содержащему `embeddings`.
  - `input` union, required: Текст для эмбеддинга. Принимает: одну строку, массив строк (батч), массив токен-ID или массив массивов токен-ID. Максимум 2048 элементов в батче.
    - string
    - string[]
    - integer[]
    - array[]
      - integer[]
  - `encoding_format` 'float' | 'base64': `float` (по умолчанию) — массив чисел в `embedding`. `base64` — base64-строка.
  - `dimensions` integer: Уменьшенная размерность вектора. Поддерживается только моделями `text-embedding-3-*`.
  - `user` string: Опциональный идентификатор конечного пользователя (для логов абьюза провайдера).

## Response `200`

Успешный ответ — список эмбеддингов в порядке `input`.

- EmbeddingsResponse
  - `object` 'list', required
  - `data` Embedding[], required
    - `object` 'embedding', required
    - `index` integer, required
    - `embedding` unknown
  - `model` string, required
  - `usage` EmbeddingsUsage, required
    - `prompt_tokens` integer, required
    - `total_tokens` integer, required

## Other responses

- `400`: Невалидное тело запроса
- `401`: Невалидный API-ключ
- `402`: Недостаточно средств на балансе
- `404`: Модель не найдена или не поддерживает embeddings
- `429`: Превышен дневной лимит ключа
- `502`: Ошибка апстрима
- `503`: Курс ЦБ РФ временно недоступен
- `504`: Таймаут апстрима

---

[API](https://skmtc.dev/hubris/apis/hubris-api.md) · [All operations](https://skmtc.dev/hubris/apis/hubris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hubris/apis/hubris-api/revisions/79ea91ed8f10?raw)