Генерация изображений NovelAI

rout.my отдаёт полный каталог NovelAI Diffusion через стандартный OpenAI-совместимый эндпоинт изображений. Все 144 рабочие модели доступны с префиксом novelai/ — отдельный аккаунт и подписка NovelAI не нужны.

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

curl https://api.rout.my/v1/images/generations \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "novelai/nai-diffusion-4-5-full-1024x1024-s28",
    "prompt": "спокойное горное озеро на рассвете, туман над водой",
    "n": 1
  }'

Ответ — стандартный формат OpenAI images: в data[0].b64_json лежит PNG.

Именование моделей

Все параметры генерации зашиты в ID модели:

novelai/nai-diffusion-<версия>-<ШxВ>-s<шаги>

Часть	Значение	Примеры
версия	семейство модели	4-full, 4-5-curated, 5-full, 4-curated-preview
ШxВ	разрешение	1024x1024, 1216x832, 1536x1536
s<шаги>	число шагов	s20 (быстро), s24 (баланс), s28 (качество)

Доступные разрешения: 832x1216, 1216x832, 1024x1024, 1024x1536, 1536x1024, 1344x768, 768x1344, 1536x1536.

Шесть семейств × восемь разрешений × три шага = 144 модели. Полный список — в каталоге моделей: полностью здоровые семейства свёрнуты в одну строку, кликните её чтобы развернуть.

Как выбрать модель

• nai-diffusion-4-5-full — последняя полная модель, лучшее качество.
• nai-diffusion-4-5-curated — курируемый вариант, более эстетичные дефолты.
• nai-diffusion-5-full / nai-diffusion-5-curated — новое поколение.
• nai-diffusion-4-curated-preview — старая preview-линейка, самый дешёвый тариф.
• Шаги: s20 для черновиков и подбора промпта, s28 для финальных рендеров.

Параметры запроса

{
  "model": "novelai/nai-diffusion-4-5-full-1024x1024-s28",
  "prompt": "спокойное горное озеро на рассвете",
  "negative_prompt": "blurry, lowres, watermark",
  "n": 1
}

Параметр	Тип	Описание
model	строка	Обязателен. Полный ID модели с префиксом novelai/.
prompt	строка	Обязателен. Что генерировать.
negative_prompt	строка	Необязателен. Добавляется к промпту как негативная директива — upstream принимает его дословно.
n	число	Количество изображений за запрос.

WARNING

Разрешение и число шагов — часть ID модели, отдельных параметров size и steps нет. Выбирайте точный вариант из каталога.

Тарификация

Каждая модель тарифицируется за сгенерированное изображение. Множитель растёт вместе со стоимостью варианта: самый дешёвый тариф (1024x1024, s20, curated preview) — 5.0×, а большие разрешения и больше шагов её умножают — 1536x1536 s28 у полной модели доходит до 202.0× за картинку. Точный множитель указан рядом с каждой моделью в каталоге дашборда.

Все модели NovelAI требуют платный тариф.

Референсы изображений (img2img)

NovelAI принимает один референс-кадр на запрос через chat-completions endpoint. Передайте картинку как стандартный OpenAI vision-блок image_url (data: URI или ссылку на хост) в сообщении пользователя вместе с промптом:

{
  "model": "novelai/nai-diffusion-4-curated-preview-1024x1024-s20",
  "messages": [
    {
      "role": "user",
      "content": [
        {"type": "text", "text": "redraw this character in watercolor"},
        {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}
      ]
    }
  ]
}

Апстрим жёстко требует ровно одну картинку на запрос — при двух и более вернёт HTTP 400. Ошибка автоматически переводится в читаемый текст: клиент увидит «NovelAI image reference supports exactly one input image per request» вместо сырого ответа апстрима.

В SillyTavern это соответствует прикреплению одной картинки к сообщению (скрепкой или [img]-тэгом) при использовании chat-completion источника — тот же сценарий, что у любой vision-модели.

Использование во фронтендах

Подходит любой клиент с поддержкой OpenAI images API. Укажите https://api.rout.my/v1, свой ключ и ID модели novelai/....

Для SillyTavern настройте кастомный бэкенд генерации изображений с эндпоинтом выше — общий принцип настройки Chat Completion описан в гайде по SillyTavern, для картинок используйте /v1/images/generations.

Ограничения и поведение

• Один запрос = одно изображение на каждый n; пакетная генерация поддерживается.
• Один референс на img2img-запрос (см. раздел выше).
• Upstream не принимает стриминг, поэтому генерация синхронная — закладывайте несколько секунд на картинку в зависимости от шагов и разрешения.
• Старые семейства nai-diffusion-3 и nai-diffusion-furry-3 намеренно не предоставляются — их upstream-канал нестабилен.