Эмбеддинги

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

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

POST/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

Не поддерживается. Весь объект игнорируется и удаляется перед отправкой; он не может выбирать upstream или ценовой уровень.

POST /v1/embeddings

1
2
3
4
5
6
7
curl https://api.bazaarlink.ai/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 — сумма в USD, списанная с клиента за этот запрос. Непрозрачный ID запроса BazaarLink в ответе совпадает с x-request-id; используйте его в GET /v1/generation. Статистика может появиться через несколько секунд; недолго повторяйте запрос при 404. В нестриминговом ответе тот же ID также передается в x-generation-id.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
  "id": "85e6f35c71a31f19-SJC",
  "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
  }
}