ДокументацияПоддержка
Основы

NovelAI V4.5 и V5

Выбор точной модели, text-to-image и img2img с одной референсной картинкой.

Все руководства (.md)

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

В каталоге NovelAI показан четырьмя карточками: V4.5 Curated, V4.5 Full, V5 Curated и V5 Full. Внутри карточки выберите разрешение и 20, 24 или 28 шагов, затем скопируйте получившийся точный model ID.

Часть IDЗначение
novelai/nai-diffusion-4-5-…NovelAI V4.5
novelai/nai-diffusion-5-…NovelAI V5
curated / fullВерсия датасета
1024x1024Разрешение
s20 / s24 / s28Количество шагов
Разрешение и шаги уже зашиты в model ID. Поле size не требуется и не меняет выбранный SKU.

Text-to-image

Для обычной генерации используйте OpenAI-совместимый endpoint изображений. Ответ содержит изображение в data[0].b64_json.

1curl https://elysiumai.garden/v1/images/generations   -H "Authorization: Bearer $ELYSIUM_API_KEY"   -H "Content-Type: application/json"   -d '{2    "model": "novelai/nai-diffusion-5-curated-1024x1024-s20",3    "prompt": "1girl, detailed eyes, cinematic light",4    "negative_prompt": "low quality, blurry"5  }'

Img2img с референсом

Референс передаётся через Chat Completions как один content-part типа image_url. Поддерживаются публичный HTTPS URL и data URL. Текстовый part содержит промпт; negative_prompt можно передать на верхнем уровне запроса.

1{2  "model": "novelai/nai-diffusion-5-full-1024x1024-s24",3  "stream": false,4  "negative_prompt": "low quality, blurry",5  "messages": [{6    "role": "user",7    "content": [8      {"type": "text", "text": "same character, night city, detailed illustration"},9      {"type": "image_url", "image_url": {"url": "data:image/png;base64,..."}}10    ]11  }]12}
NovelAI принимает ровно одну входную картинку. Запрос с двумя и более image_url будет отклонён до обращения к провайдеру.

Форматы и ограничения

  • POST /v1/images/generations — генерация только из текста.
  • POST /v1/chat/completions — генерация из текста или img2img с одной картинкой.
  • Референс нельзя передать через /v1/images/generations: используйте vision-формат Chat Completions.
  • Внешние клиенты видят все 96 точных SKU через GET /v1/models.
  • Цена указана за одно выходное изображение и зависит от точного SKU.
Термины на этой странице
ТерминЧто означает
Base URLБазовый адрес API, к которому клиент добавляет нужный маршрут.
API-ключСекрет для авторизации и списания запросов с вашего баланса.
Model IDТочное системное имя модели из каталога Elysium AI.
EndpointМаршрут конкретной операции после базового адреса API.
RequestОдин запрос клиента к API вместе с его заголовками и телом.
ResponseРезультат обработки запроса: статус, заголовки и данные.