ZvenoAI
API Reference

List Models

GET
/v1/models

Возвращает список доступных LLM-моделей в формате, совместимом с OpenAI Models API. Авторизация не требуется.

Поддерживает:

  • Поиск по названию, вендору и описанию (search)
  • Фильтрацию по типу модели (model_type: chat, audio_transcription)
  • Гибкую сортировку (по цене, контексту, рейтингу и др.)
  • Пагинацию

Каждая модель содержит информацию о вендоре, контекстном окне, поддерживаемых модальностях, ценах и возможностях (tool use, vision, streaming и др.).

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

search?string

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

model_type?string

Фильтр по типу модели (chat, audio_transcription)

sort_by?string

Поле для сортировки (name, display_name, vendor, context_length, price, avg_price, created_at, input_price, output_price, rank, popularity). popularity — по умолчанию, по убыванию (desc). rank устарел и будет удалён в 4.0.0.

sort_order?string

Направление сортировки (asc, desc); для popularity по умолчанию desc.

page?integer

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

Formatint32
per_page?integer

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

Formatint32

Response Body

application/json

curl -X GET "http://localhost:8080/v1/models"
{
  "object": "string",
  "data": [
    {
      "id": "string",
      "base_model": "string",
      "object": "string",
      "created": 0,
      "owned_by": "string",
      "vendor": "string",
      "name": "string",
      "model_type": "string",
      "context_length": 0,
      "pricing": {
        "prompt": "string",
        "completion": "string",
        "input_cache_read": "string",
        "input_cache_write": "string",
        "internal_reasoning": "string",
        "image_output": "string",
        "audio": "string",
        "audio_second": "string",
        "audio_output": "string",
        "web_search": "string",
        "request": "string"
      },
      "price_in_per_1k": "string",
      "price_out_per_1k": "string",
      "description": "string",
      "supported_parameters": [
        "string"
      ],
      "image_parameters": {
        "property1": {
          "type": "enum",
          "values": [
            "string"
          ],
          "min": 0,
          "max": 0,
          "min_pixels": 0,
          "max_pixels": 0,
          "max_edge": 0,
          "multiple_of": 0,
          "max_aspect_ratio": 0.1
        },
        "property2": {
          "type": "enum",
          "values": [
            "string"
          ],
          "min": 0,
          "max": 0,
          "min_pixels": 0,
          "max_pixels": 0,
          "max_edge": 0,
          "multiple_of": 0,
          "max_aspect_ratio": 0.1
        }
      },
      "popularity_users_30d": 0,
      "popularity_computed_at": "2019-08-24T14:15:22Z"
    }
  ]
}

Messages POST

Создает запрос к LLM-модели через Anthropic Messages API. Совместим с Anthropic SDK и Claude Code — можно использовать любой Anthropic SDK, указав `base_url: "https://api.zveno.ai"`. Поддерживает: - Обычный и streaming (`stream: true`) режимы - Tool use (function calling) - Vision (изображения в сообщениях) - Extended thinking - Prompt caching (`cache_control`) - Computer use tools - Автоматический failover между провайдерами Модель указывается в формате `vendor/model` (например, `anthropic/claude-sonnet-4-20250514`). Аутентификация: `Authorization: Bearer <api-key>` или `x-api-key: <api-key>`. Заголовок `x-api-key` автоматически нормализуется для совместимости с Claude Code и Anthropic SDK. Тело запроса проксируется к провайдеру без конвертации формата, единственное преобразование — замена поля `model` на provider-specific ID. При включённой Маске дополнительно выполняются преобразования, описанные в поле maska_enabled ключа API. Ошибки возвращаются в формате Anthropic: `{"type": "error", "error": {"type": "<error_type>", "message": "<message>"}}`.

List Model Providers GET

Возвращает список провайдеров для конкретной модели с информацией о ценах, поддерживаемых возможностях (streaming, tool use) и статусе. Путь: `/v1/models/{vendor}/{model}/providers` (например, `/v1/models/anthropic/claude-sonnet-4-20250514/providers`).