---
title: "Запрос на генерацию вектора встраивания"
method: POST
path: "/v1/embeddings"
tags: ["Creation"]
---

# Запрос на генерацию вектора встраивания

`POST /v1/embeddings`

Эта конечная точка служит для создания вектора встраивания, представляющего входной текст с помощью нейросетей. **Для доступа требуется авторизация.**

## Request body

- CreateEmbeddingsForm — Тело запроса для создания эмбеддингов.
  - `input` union, required — Входной текст для эмбеддинга, закодированный как строка или массив строк. Чтобы встроить несколько входов в один запрос, передайте массив строк. Входные данные не должны превышать максимальное количество токенов для модели (8192 токена для всех моделей эмбеддингов), не могут быть пустой строкой, и любой массив должен содержать не более 2048 элементов.
    - string
    - string[]
  - `model` string, required — ID модели для использования. Вы можете использовать API 'List models' для просмотра всех доступных моделей или обратиться к обзору моделей.
  - `dimensions` integer, nullable — Количество измерений, которые должны иметь результирующие выходные эмбеддинги. Поддерживается только в моделях text-embedding-3 и более новых.
  - `encoding_format` 'float' | 'base64' — Формат, в котором возвращаются эмбеддинги.
  - `user` string, nullable — Уникальный идентификатор, представляющий вашего конечного пользователя, который может помочь OpenAI отслеживать и обнаруживать злоупотребления.

## Response `200`

Successful Response

- CreateEmbeddingsResponse — Ответ от API создания эмбеддингов.
  - `id` string, required
  - `created` integer, required
  - `object` 'list', required — Тип объекта, обычно 'list' для списков результатов.
  - `data` EmbeddingData[], required — Список объектов эмбеддингов.
    - `object` 'embedding', required — Тип объекта, всегда 'embedding'.
    - `embedding` union, required — Вектор эмбеддинга. Список чисел с плавающей точкой или строка в формате base64, если encoding_format был 'base64'. Длина вектора зависит от модели.
      - number[]
      - string
    - `index` integer, required — Индекс эмбеддинга в списке эмбеддингов.
  - `model` string, required — Модель, которая была использована для генерации эмбеддингов.
  - `usage` EmbeddingsUsage, required — Информация об использовании токенов в запросе.
    - `prompt_tokens` integer, required — Количество токенов в запросе.
    - `total_tokens` integer, required — Общее количество токенов, обработанных в запросе.
    - `total_time` number, nullable, required
    - `cost_request` number, nullable, required
    - `free_request` boolean, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hydraai/apis/hydraai-api.md) · [All operations](https://skmtc.dev/hydraai/apis/hydraai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hydraai/hydraai-api/revisions/e628fe769ab4/schema)