Обзор Yes Ai API Qwen Images. Как устанавливать и использовать LoRA - часть 4
LoRA (Low-Rank Adaptation) — особый вид моделей, который позволяет нейросети Qwen использовать дополнительные знания при генерации изображений. С помощью LoRA можно «научить» сеть новым стилям, добавить в ее арсенал конкретных персонажей, типажи людей или дать ей вдохновение новым образом. Пользователи по всему миру самостоятельно обучают такие модели и выкладывают результаты на площадке civitai.com. Оттуда вы легко добавите понравившиеся LoRA в библиотеку Yes Ai — как для себя, так и для своих клиентов.
Часть LoRA уже встроена и готова к работе через Qwen API. Но если чего-то вам не хватает — ничего сложного, нужные LoRA добавляются по специальному запросу.
Разберёмся в деталях. На civitai.com у каждой LoRA свой уникальный ID. Именно он понадобится, чтобы загружать или подключать новые стили и образы в Yes Ai. Как именно устроен раздел с галереями, где искать подходящие модели и как интегрировать их в Qwen Images — об этом подробно рассказываем в отдельном материале.
Как узнать, какие модели LoRA доступны в Yes Ai
Если вы хотите подключить генерацию с LoRA для Qwen Images, сначала потребуется получить актуальный список моделей из базы Yes Ai. Генерация возможна только с теми LoRA, которые уже есть на платформе. Если нужной модели нет в списке, использовать её не получится.
Добавить новую LoRA в Yes Ai можно вручную. Но до этого стоит реализовать механизм, который синхронизирует доступные модели с базой сервиса.
GET https://api.yesai.su/v2/qwen/lora/models
headers: { Content-Type: application/json, Authorization: Bearer }
Ошибки:
['success' => false, 'message' => 'LIMIT_OFFSET_IS_EMPTY'], 400
['success' => false, 'message' => 'LIMIT_OFFSET_NOT_VALID'], 400
['success' => false, 'message' => 'LIMIT_COUNT_IS_EMPTY'], 400
['success' => false, 'message' => 'LIMIT_COUNT_NOT_VALID'], 400
['success' => false, 'message' => 'SORT_FIELD_IS_EMPTY'], 400
['success' => false, 'message' => 'SORT_FIELD_NOT_VALID'], 400
['success' => false, 'message' => 'SORT_ORDER_IS_EMPTY'], 400
['success' => false, 'message' => 'SORT_ORDER_NOT_VALID'], 400
['success' => false, 'message' => 'DATA_TYPE_IS_EMPTY'], 400
['success' => false, 'message' => 'DATA_TYPE_NOT_VALID'], 400
['success' => false, 'message' => 'ID_OFFSET_IS_EMPTY'], 400
['success' => false, 'message' => 'ID_OFFSET_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'USER_HAS_BEEN_BANNED'], 409
['success' => false, 'message' => 'USER_HAS_BEEN_DELETED'], 409
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500
Ответ при успешном запросе:
['success' => true, 'message' => 'OK', 'results' => ['models_data' => [ ... ]]], 200
Советуем обновлять базу данных моделей хотя бы раз в сутки. Дело в том, что устаревшие LoRA периодически удаляются, а свежие появляются довольно часто. Если настроить регулярную синхронизацию, вы не столкнётесь с ошибками при генерации, когда кто-нибудь попробует создать изображение с помощью уже недоступной LoRA-модели.
Как отправить задание на генерацию изображения с LoRA-моделью в нейросети Qwen Images через API
Алгоритм простой. В документации по работе с API подробно описан формат задания. В параметре "prompt" указываете текстовое описание, а к самому промту добавляете специальный ключ нужной LoRA-модели.
Синтаксис ключа:
xxx:y>
Где xxx — идентификатор LoRA c сайта Civitai,
y — числовой весовой коэффициент (можно подобрать экспериментально).
Некоторые LoRA требуют триггерные слова. Их тоже вписываете в промт — иначе результат не появится, проверено на практике.
Пример API-запроса на генерацию изображения с LoRA в Qwen Images
Чтобы всё работало, структура запроса выглядит вот так:
Проверьте статус выполнения заданий — для этого предусмотрен отдельный эндпойнт. Его точное описание найдете прямо в этом документе.
Развернутую информацию о триггерных словах и номерах LoRA-моделей вы найдете по ссылке на статью.
Как добавить модель LoRA в галерею Yes Ai
Чтобы LoRA заработала при генерациях Qwen, необходимо, чтобы было выполнено хотя бы одно условие:
- Модель уже есть в галерее Yes Ai.
- Вы подали запрос на добавление модели, и система подтвердила ее установку.
Добавление LoRA-модели Qwen в Yes Ai через API
Нужен уникальный идентификатор модели. Его проще всего взять из прямой ссылки на модель в каталоге Civitai.
Пример такой ссылки:
https://civitai.com/models/1938784/2dhd-pixel-art-octopath-style
Числовой идентификатор: 1938784 (его легко вытащить простым парсером).
Пример:
разбираемся, как добавить модель с номером 1938784 в Yes Ai через API.
Пример запроса к API для добавления LoRA Qwen Images в базу Yes Ai:
Параметры:
- id = 1938784 — это обязательный параметр, номер LoRA-модели для добавления в библиотеку.
Возможные ошибки:
['success' => false, 'message' => 'ID_IS_EMPTY'], 400
['success' => false, 'message' => 'ID_NOT_VALID'], 400
['success' => false, 'message' => 'UNAUTHORIZED'], 401
['success' => false, 'message' => 'ID_NOT_FOUND'], 404
['success' => false, 'message' => 'USER_HAS_BEEN_BANNED'], 409
['success' => false, 'message' => 'USER_HAS_BEEN_DELETED'], 409
['success' => false, 'message' => 'NOT_ENOUGH_RPOINTS'], 409
['success' => false, 'message' => 'NSFW_CONTENT_FOUND'], 409
['success' => false, 'message' => 'TOO_MANY_REQUESTS'], 429
['success' => false, 'message' => 'TOO_MANY_INSTALLATIONS'], 429
['success' => false, 'message' => 'INTERNAL_SERVER_ERROR'], 500
Ответ при удачном добавлении выглядит так:
['success' => true, 'message' => 'OK', 'results' => ['model_data' => [ ... ]]], 200
Как только модель установится, она появится в вашей библиотеке и будет доступна для генерации изображений. Я советую реализовать небольшое уведомление для пользователя — пусть знают, что новая модель готова к работе. Практика показывает, что удобнее всего пользоваться галереей моделей с визуальными карточками: клиент выбирает нужную LoRA буквально в пару кликов. Прошли времена, когда промт нужно было собирать вручную.
Имейте в виду, установка новой LoRA в систему Yes Ai может занять от 5 до 15 минут. Всё зависит от объема самой модели. Чем тяжелее файлы, тем дольше процесс.
Лайфхак: после каждого успешного добавления LoRA через API для Qwen Images сразу синхронизируйте вашу внутреннюю базу — номера моделей и ключей должны всегда совпадать с теми, что доступны пользователям.
И ещё момент — если кто-то попробует сгенерировать изображение через несуществующую в базе Yes Ai LoRA, система перейдёт к обычной генерации по промту. LoRA в этом случае просто не будет задействована.