EmbeddingsRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/hubris-pw/json-schema/hubris-pw-embeddings-request-schema.json",
  "title": "EmbeddingsRequest",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/hubris-pw-openapi.json#/components/schemas/EmbeddingsRequest",
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "minLength": 1,
      "description": "ID embedding-модели — например, `openai/text-embedding-3-small`. Полный список: GET /v1/models, отфильтруйте по `output_modalities` содержащему `embeddings`."
    },
    "input": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "array",
          "items": {
            "type": "integer"
          }
        },
        {
          "type": "array",
          "items": {
            "type": "array",
            "items": {
              "type": "integer"
            }
          }
        },
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "content": {
                "type": "array",
                "items": {
                  "oneOf": [
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "text"
                          ]
                        },
                        "text": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "text"
                      ]
                    },
                    {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string",
                          "enum": [
                            "image_url"
                          ]
                        },
                        "image_url": {
                          "type": "object",
                          "properties": {
                            "url": {
                              "type": "string",
                              "minLength": 1
                            }
                          },
                          "required": [
                            "url"
                          ]
                        }
                      },
                      "required": [
                        "type",
                        "image_url"
                      ]
                    }
                  ]
                },
                "minItems": 1
              }
            },
            "required": [
              "content"
            ]
          }
        }
      ],
      "description": "Что превратить в вектор. Принимает: одну строку, массив строк (батч), массив токен-ID, массив массивов токен-ID или массив объектов `{content: [...]}` с частями `text` и `image_url` — для моделей с изображениями на входе (`input_modalities` содержит `image`). Максимум 2048 элементов в батче."
    },
    "encoding_format": {
      "type": "string",
      "enum": [
        "float",
        "base64"
      ],
      "description": "`float` (по умолчанию) — массив чисел в `embedding`. `base64` — base64-строка."
    },
    "dimensions": {
      "type": "integer",
      "minimum": 0,
      "exclusiveMinimum": true,
      "description": "Уменьшенная размерность вектора. Поддерживается только моделями `text-embedding-3-*`."
    },
    "user": {
      "type": "string",
      "description": "Опциональный идентификатор конечного пользователя (для логов абьюза провайдера)."
    }
  },
  "required": [
    "model",
    "input"
  ]
}