Visnea API
Справочник моделей
Каталог живёт в GET /v1/models и всегда актуален: имена, цены и схема параметров каждой модели. Ниже — тот же каталог, отрисованный прямо из API.
Эндпоинт
GET
/v1/modelscurl https://visnea-labs.com/v1/models \ -H "Authorization: Bearer sk-visnea-..."Ответ — массив models. Ключевые поля описаны ниже; form — это схема модельных параметров, каждый её ключ передаётся верхнеуровневым полем в теле /v1/generate.
| Параметр | Тип | Описание |
|---|---|---|
id | string | Идентификатор модели — значение для model_id. |
kind | enum | Модальность: image | video | audio | chat. |
name | string | Отображаемое имя модели. |
price_cherries | number | Базовая цена в вишенках (для видео — за секунду; для озвучки может считаться блоками символов char_block; поля с affectsPrice меняют итог). |
form | object[] | Схема параметров: [{ key, type, label, options, min, max, default }]. type select/buttons — перечисление options[].value; count/number — число в границах min–max. |
max_prompt_chars | number | Лимит длины промпта в символах — сверх него придёт ошибка prompt_too_long. |
aspect_ratios | string[] | Допустимые соотношения сторон для aspect_ratio. |
supports_refs | boolean | Модель принимает reference_images; max_refs — сколько максимум. |
…flags | mixed | Флаги возможностей: supports_start_frame / supports_end_frame (кадры для видео), requires_mask (маска), music (генерация музыки), op (инструмент редактирования). |
Пример элемента каталога
{ "id": "example-video", "kind": "video", "name": "Example Video", "price_cherries": 6, "aspect_ratios": ["16:9", "9:16", "1:1"], "max_seconds": 15, "max_prompt_chars": 2000, "supports_refs": true, "max_refs": 2, "form": [ { "key": "resolution", "type": "buttons", "default": "480p", "options": [ { "value": "480p" }, { "value": "720p" } ] }, { "key": "duration", "type": "count", "min": 5, "max": 15, "default": 5 } ]}Такой модели передают resolution и duration прямо в теле запроса: { "model_id": "example-video", "prompt": "…", "resolution": "720p", "duration": 10 }.
Живой каталог
Данные ниже загружаются из /v1/models в реальном времени — это точный контракт API для каждой модели.