API Нейроново

API позволяет генерировать изображения и видео теми же моделями, что и в студии: из своего сервера, бота, CRM или интернет-магазина. Оплата — Мыслями с вашего баланса, как в студии. Если генерация не удалась, Мысли возвращаются по тем же правилам, что и в студии.


Базовый адрес	`https://neuronovo.ru/api/v1`
Формат	JSON (UTF-8), загрузка файлов — multipart/form-data
Авторизация	Заголовок `Authorization: Bearer nn_live_…`
Модель работы	Асинхронные задачи: создаёте задачу → получаете результат опросом или вебхуком

За 3 шага

Создайте ключ в личном кабинете → API. Ключ показывается один раз — сохраните его в переменной окружения NEURONOVO_API_KEY.
Отправьте запрос на генерацию. Ответ придёт сразу (код 202) с идентификатором задачи.
Опрашивайте GET /v1/tasks/{id} раз в 3–5 секунд или укажите callback_url, и мы сами пришлём результат.

# 1. Создать задачу
curl -s https://neuronovo.ru/api/v1/images/generations \
  -H "Authorization: Bearer $NEURONOVO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model": "nanobanana-2",
    "prompt": "Уютная кофейня в дождливом Петербурге, тёплый свет, 35 мм",
    "resolution": "2K",
    "aspect_ratio": "16:9"
  }'

# 2. Проверить статус (подставьте id из ответа)
curl -s https://neuronovo.ru/api/v1/tasks/TASK_ID -H "Authorization: Bearer $NEURONOVO_API_KEY"

Статусы задачи

Статус	Что означает
`pending`	Ждёт в очереди аккаунта: заняты все слоты вашего тарифа или общий пул модели. Запустится автоматически.
`queued`	Передана в очередь выполнения.
`processing`	Генерируется.
`succeeded`	Готово. Ссылки на файлы — в result.files.
`failed`	Не удалось. Причина — в error, возврат Мыслей — в refund.
`cancelled`	Отменена вами или истекло время ожидания в очереди. Мысли возвращены полностью.

Методы

Метод	Назначение
`GET /v1/models`	Список моделей, параметры и цены
`POST /v1/files`	Загрузка изображения для img2img и видео по кадру
`POST /v1/images/generations`	Создать задачу генерации изображения
`POST /v1/videos/generations`	Создать задачу генерации видео
`GET /v1/tasks/{id}`	Статус и результат задачи
`GET /v1/tasks`	История задач API
`DELETE /v1/tasks/{id}`	Отменить задачу, ожидающую в очереди (полный возврат)
`GET /v1/account`	Баланс, очередь, лимиты ключа

Ключ даёт доступ к вашему балансу. Храните его только на сервере. Не вставляйте ключ в код сайта, мобильного приложения или в публичный репозиторий. Задайте ключу дневной лимит трат и список разрешённых IP — это ограничит ущерб при утечке.

Проверить запрос без списания можно параметром "dry_run": true: API проверит параметры, баланс и лимиты и вернёт стоимость, но задачу не создаст.