Submit an embedding request

POST https://api.alltokens.ru/api/v1/embeddings
Content-Type: application/json

Отправка текста для получения векторного представления (embedding).

Заголовки

Заголовок	Обязательный
Authorization: Bearer <API_KEY>	Да
Content-Type: application/json	Да

Тело запроса

Поле	Тип	Обязательный	Описание
model	string	Да	Идентификатор embedding-модели (см. Embedding models)
input	string \| string[]	Да	Текст или массив текстов для эмбеддинга
encoding_format	string	Нет	Например `float` (по умолчанию) или `base64`
dimensions	number	Нет	Размерность вектора (если модель поддерживает)
user	string	Нет	Идентификатор пользователя для логирования

Пример (curl)

bash

curl -X POST "https://api.alltokens.ru/api/v1/embeddings" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-3-small",
    "input": "The quick brown fox jumps over the lazy dog."
  }'

Ответ (200)

Поле	Тип	Описание
object	string	Обычно `list`
data	array	Массив объектов с эмбеддингами (см. ниже)
model	string	Модель
usage	object	Использование токенов (см. ниже)

data[]

Поле	Тип	Описание
object	string	Обычно `embedding`
index	number	Индекс в массиве input
embedding	number[] \| string	Вектор (массив float или base64, в зависимости от encoding_format)

usage

Поле	Тип	Описание
prompt_tokens	number	Токены входа
total_tokens	number	Всего токенов

Коды ответов

Код	Описание
200	Успех
400	Неверное тело запроса
401	Не авторизован
404	Модель не найдена
429	Лимит запросов
500	Внутренняя ошибка