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)

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/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_output": "string",
        "web_search": "string",
        "request": "string"
      },
      "price_in_per_1k": "string",
      "price_out_per_1k": "string",
      "description": "string",
      "supported_parameters": [
        "string"
      ]
    }
  ]
}

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. Ошибки возвращаются в формате 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`).