ДокументацияМодели и баланс

Модели и баланс

Zenvy отдаёт список доступных моделей и баланс аккаунта через отдельные методы API.

GET /v1/models

Публичный метод — API-ключ не нужен.

~/zenvy · zsh

curl https://api.zenvy.su/v1/models

Пример ответа:

~/zenvy · json

{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-4.6",
      "object": "model",
      "owned_by": "zenvy",
      "pricing": {
        "input_rub_per_1m": 500,
        "output_rub_per_1m": 1500
      },
      "features": {
        "streaming": true,
        "available": true,
        "tools": true,
        "reasoning": true
      },
      "architecture": {
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"]
      },
      "context_window": 200000,
      "max_output_tokens": 8192
    }
  ]
}

Поле id — это имя модели для параметра model в запросах. Цены указаны в рублях за 1 миллион токенов.

Поле	Значение
`architecture.input_modalities`	Что модель понимает на входе: `text`, `image`, `audio`, `video`, `file`
`architecture.output_modalities`	Что модель генерирует: `text`, `image`, `audio`, `video`
`features.tools`	Поддержка tool calling
`features.reasoning`	Режим размышления (reasoning)
`features.streaming`	Потоковые ответы через SSE

Актуальный каталог с фильтрами и сортировкой — на странице моделей.

GET /v1/balance

Приватный метод — нужен API-ключ.

~/zenvy · zsh

curl https://api.zenvy.su/v1/balance \
  -H "Authorization: Bearer sk-zenvy-..."

Пример ответа:

~/zenvy · json

{
  "balance_rub": 1200,
  "total_balance_rub": 1200
}

Поле	Описание
`balance_rub`	Текущий баланс (₽)
`total_balance_rub`	Итоговый баланс (₽)

Как списывается баланс

Стоимость запроса считается по тарифу модели и количеству токенов и списывается с баланса.
Если средств недостаточно, API вернёт ошибку insufficient_balance.

Подробнее об ошибках: Ошибки и диагностика.