API Reference

List Embedding Models

Возвращает список доступных embedding моделей с информацией о размерности, ценах и поддерживаемых возможностях.

Авторизация не требуется.

Authorization

BearerAuth

AuthorizationBearer <token>

In: header

Query Parameters

search?string

Поиск по названию, вендору или описанию

model_type?string

Фильтр по типу модели

sort_by?string

Поле для сортировки

sort_order?string

Направление сортировки (asc, desc)

page?integer

Номер страницы

Formatint32

per_page?integer

Количество на странице (max 100)

Formatint32

Response Body

`application/json`

curl -X GET "http://localhost:8080/v1/embeddings/models"

{
  "object": "string",
  "data": [
    {
      "id": "string",
      "slug": "string",
      "base_model": "string",
      "object": "string",
      "created": 0,
      "owned_by": "string",
      "vendor": "string",
      "display_name": "string",
      "model_type": "string",
      "context_length": 0,
      "price_in_per_1k": "string",
      "price_out_per_1k": "string",
      "description": "string"
    }
  ]
}

Create Embeddings POST

Генерирует векторные представления (embeddings) для текста. Совместим с OpenAI Embeddings API — можно использовать любой OpenAI SDK, указав `base_url: "https://api.zveno.ai/v1"`. Поддерживает: - Единичный и batch input (строка или массив строк) - Выбор формата (float, base64) - Настройки выбора провайдера (`provider`) Модель указывается в формате `vendor/model` (например, `openai/text-embedding-3-small`). Аутентификация: `Authorization: Bearer <api-key>`.

Audio Transcriptions POST

Транскрибирует аудиофайл в текст. Совместим с OpenAI Audio Transcriptions API — можно использовать любой OpenAI SDK, указав `base_url: "https://api.zveno.ai/v1"`. Ограничение на размер файла: **25 MB**. Поддерживаемые форматы входного аудио: `mp3`, `mp4`, `mpeg`, `mpga`, `m4a`, `wav`, `webm`. Формат ответа (`response_format`) зависит от модели: - `openai/whisper-1` — `json`, `text`, `srt`, `verbose_json`, `vtt` - `openai/gpt-4o-transcribe`, `openai/gpt-4o-mini-transcribe` — `json`, `text` - `openai/gpt-4o-transcribe-diarize` — `json`, `text`, `diarized_json` (с сегментами по говорящим) Референсные аудио-сэмплы говорящих (`known_speaker_references`) передаются как data URLs и принимают те же форматы, что и входной файл. Модель указывается в формате `vendor/model` (например, `openai/whisper-1`). Аутентификация: `Authorization: Bearer <api-key>`.