Создание вложений

Преобразует текст (или, для моделей, которые его поддерживают, мультимодальное содержимое) в векторные внедрения. Формы запроса и ответа соответствуют встраиваниям OpenAI API, поэтому они работают напрямую с client.embeddings.create(). ввод принимает одну строку или массив строк.

POST/api/v1/embeddings

Авторизация

Authorizationобязательно

string · header

Ключ API как Bearer-токен в заголовке Authorization.

Тело

modelобязательно

string

Используемая модель внедрения, указанная поставщиком, например. «openai/text-embedding-3-small».

minLength: 1

Example: "openai/text-embedding-3-small"

inputобязательно

string | string[]

Текст для вставки. Принимает одну строку или массив строк для встраивания нескольких входных данных в один запрос. Некоторые модели дополнительно принимают элементы структурированного мультимодального контента, пересылаемые в восходящий поток как есть; фактическая поддержка зависит от модели.

Example: "The quick brown fox"

encoding_format

string

Формат кодирования, пересылаемый в восходящий поток как есть, без локальной проверки; поддерживаемые значения зависят от восходящего потока.

Example: "float"

dimensions

integer

Число измерений выходного вектора, пересылаемого в восходящий поток как есть, без локальной проверки; только некоторые модели поддерживают специальные размеры, и вышестоящая сторона определяет поведение (обычно игнорирует или выдает ошибку), если они не поддерживаются.

provider

object

Настройки маршрутизации поставщика (порядок, только, игнорировать,allow_fallbacks, сортировка, …). Пересылается и принимается только на определенных модельных маршрутах; неподдерживаемые маршруты отбрасывают его автоматически и никогда не отправляют вверх по течению.

POST /api/v1/embeddings

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/embeddings \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/text-embedding-3-small",
    "input": "The quick brown fox"
  }'

Примеры ответов

Успех. Возвращает фигуру, совместимую с OpenAI; data[] соответствует каждому входу по порядку, а Usage.cost — это сумма, фактически выставленная за этот запрос.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
{
  "object": "list",
  "data": [
    {
      "object": "embedding",
      "index": 0,
      "embedding": [
        0.0023064255,
        -0.009327292,
        0.015797347
      ]
    }
  ],
  "model": "openai/text-embedding-3-small",
  "usage": {
    "prompt_tokens": 5,
    "total_tokens": 5,
    "cost": 1e-7
  }
}