Visnea

Visnea API

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

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

Как устроен API

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

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

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

В старых примерах адрес заканчивался на /v1/usd — это была временная защита на время перехода баланса с вишенок на доллары. Теперь адрес обычный, /v1; старый тоже продолжает работать.

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

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

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

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

  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. Если ответ пришёл со статусом 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 и правила безопасности.ГенерацияТело запроса, параметры по модальностям, ответ и поллинг.Подключение инструментовClaude Code, Claude Desktop, Codex, OpenCode, Grok, Hermes, Cherry Studio; OpenAI- и Anthropic-совместимый API.Справочник моделейЖивой каталог: параметры, лимиты промпта, форматы.ОшибкиКонверт {error, code} и все коды ошибок.