Как выбрать модель
В каталоге 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 | Результат обработки запроса: статус, заголовки и данные. |