Visnea

Visnea API

Обзор и быстрый старт

Один HTTP-API для всего каталога Visnea: изображения, видео, озвучка и чат. Аутентификация по API-ключу, оплата вишенками с того же баланса, что и в кабинете.

Как устроен API

Все запросы идут на один базовый адрес и авторизуются заголовком с вашим ключом. Формат — JSON поверх HTTPS. Один ключ покрывает все модальности: и генерацию, и чат, и плагины для редакторов.

Стоимость операций считается в вишенках и списывается с баланса аккаунта. Неудачные генерации возвращаются автоматически.

Базовый адрес
https://visnea-labs.com/v1

Быстрый старт

  1. 1

    Создайте API-ключ в кабинете (раздел «Аккаунт» или «Плагины» → «API-ключи»). Ключ показывается один раз — сохраните его.

  2. 2

    Посмотрите каталог моделей и их параметры:

    curl
    curl https://visnea-labs.com/v1/models \  -H "Authorization: Bearer sk-visnea-..."
  3. 3

    Запустите генерацию: достаточно model_id и prompt.

    curl
    curl https://visnea-labs.com/v1/generate \  -H "Authorization: Bearer sk-visnea-..." \  -H "Content-Type: application/json" \  -d '{    "model_id": "z-image",    "prompt": "неоновый город под дождём, кинематографичный свет"  }'
  4. 4

    Если ответ пришёл со статусом processing — опрашивайте генерацию по id, пока статус не станет succeeded или failed.

    curl
    curl https://visnea-labs.com/v1/generations/GEN_ID \  -H "Authorization: Bearer sk-visnea-..."
Ссылки на изображения/видео приходят в results[].url — скачайте результат или используйте URL напрямую.

Что дальше

АутентификацияКлючи sk-visnea-…, заголовок Authorization и правила безопасности.ГенерацияТело запроса, параметры по модальностям, ответ и поллинг.Справочник моделейЖивой каталог: параметры, лимиты промпта, форматы.ОшибкиКонверт {error, code} и все коды ошибок.