Введение
Qwen Image 2.1 LoRA Editing применяет ваши собственные веса LoRA, переписывая от одного до десяти референсов. Это та же схема со своими весами, что и на эндпоинте генерации по тексту, только направленная на уже готовую работу, а не на пустой кадр.
Веса, которые вы загружаете, не проверяются, а на результат не накладывается фильтр контента.
Выберите режим Qwen Image 2.1 LoRA по исходному материалу
| Исходный материал | Режим |
|---|---|
| Исходные изображения плюс ваши собственные веса | Qwen Image 2.1 LoRA Редактирование изображения |
| Бриф плюс ваши собственные веса | Qwen Image 2.1 LoRA Текст в изображение |
| Редактирование без своих весов | Qwen Image 2.1 Редактирование изображения |
Ключевые возможности и особенности
Принесите LoRA на персонажа в работу, которая уже идёт
LoRA, с которой можно только начинать новое, куда менее полезна, чем та, которую можно применить к утверждённому кадру. Этот эндпоинт берёт и то и другое: до десяти референсов и до трёх файлов весов в одном запросе.
Веса и референсы решают разные половины задачи о постоянстве
Референсы держат композицию, обстановку и конкретный кадр; LoRA держит внешность на каждом кадре. Вместе они устойчивее, чем сильный упор на что-то одно.
Без цензуры с обеих сторон
Веса не проверяются, на вывод не накладывается фильтр, а источник остаётся таким, как есть, пока инструкция не скажет иного.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Негативного промпта в этом семействе нет, поэтому исключения тоже идут сюда. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до десяти референсов. Роли модель сама не назначает, поэтому назовите в prompt, что вносит каждый источник. Не менее 1 элементов · Не более 10 элементов |
aspect_ratio | Нет | Собирает кадр до генерации, а не обрезает после. Пятнадцать вариантов: от полос 3:1 и 21:9 до колонок 1:3 и 9:21. |
resolution | Нет | Задаёт размер вывода и цену: 1k по умолчанию, 1.5k посередине, 2k там, где должны держаться фактура кожи и ткань. Итерируйте на 1k, удачный кадр поднимайте до 2k. |
loras | Нет | До трёх файлов весов, каждый вида {path, scale}. path — прямая HTTPS-ссылка на файл .safetensors или на репозиторий Hugging Face; нам ничего не загружается и ничего не проверяется. По умолчанию: |
output_format | Нет | По умолчанию JPEG; PNG — под композитинг, WebP — чтобы сразу отправить на страницу. Ни цену, ни сам рендер не меняет. |
seed | Нет | Стабилизирует выборку, чтобы серия держалась в одном регистре. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.042 / изображение |
| $0.078 / изображение |
| $0.15 / изображение |
Сценарии использования
Применение LoRA на персонажа к уже утверждённым кадрам
Дорогая часть съёмки редко в самой генерации — она в том, чтобы дойти до кадра, который все согласовали. Этот эндпоинт позволяет сохранить тот кадр и поменять, кто в нём: отправьте утверждённую композицию референсом, загрузите LoRA на персонажа и дайте весам нести внешность, пока свет, мизансцена и кадрирование остаются ровно там, где были.
Перевод старого каталога в текущий фирменный стиль
Направьте стилевую LoRA на работы, сгенерированные месяцы назад. Отправьте старые кадры референсами, загрузите стилевые веса на умеренном scale и перезапустите их, чтобы архивный кадр и новый стояли на одной странице без заметного шва между ними.
Сцена, собранная вокруг подконтрольного вам референса
Начните с уже сгенерированной фигуры и добавьте второго героя, одежду, ограничение движения или обстановку. Инструкции выполняются буквально, а веса без цензуры загружаются без проверки, так что сцену можно собирать шагами, а не ставить всё на один prompt.
Замена одежды и локации при неизменном человеке
Два референса — один несёт человека, второй одежду или комнату — плюс LoRA на персонажа и prompt, который говорит, где что. Поменяйте комнату, оставив лицо; поменяйте наряд, оставив и то и другое.
Руководство по промптам и практические советы
Сначала назовите вклад каждого референса, потом — само изменение
Модель не выводит роли ни из порядка, ни из имени файла. Напишите прямо: «первое изображение — женщина, второе — комната, в которой она стоит, третье — пальто». Без этой фразы запрос с несколькими референсами смешивает источники вместо того, чтобы редактировать ими, и результат выглядит артефактом усреднения, а не ошибкой, которую можно отладить.
Не позволяйте prompt и LoRA описывать одно и то же
Когда загружена LoRA на персонажа, описывайте сцену, действие и свет — но не лицо. Пересказ черт, которые веса уже кодируют, тянет рендер в две стороны и обычно даёт нечто не похожее ни на одну из них. Пусть LoRA владеет внешностью, а prompt — всем вокруг неё.
Защиты пишите в инструкцию, потому что негативного промпта нет
Прямо скажите, что должно пережить правку: «оставь её ровно как в источнике, ничего не добавляй к одежде» или «не меняй длину волос». Оставленная на собственное усмотрение модель редактирования приберёт то, что прибирать не просили, а в работе без цензуры именно это прибирание и есть весь провал.
Оцените стоимость запроса до отправки, а не после
Цену здесь двигают сразу две вещи — число референсов и уровень разрешения, — а надбавка за LoRA ложится сверху. Десять референсов с тремя LoRA на 2k — самая дорогая форма, которую принимает это семейство. Смета, показанная до отправки, и есть окончательная: читайте её на крупных запросах, а не считайте, что цену задаёт один уровень.
Убедитесь, что новая LoRA что-то меняет, прежде чем доверять ей партию
Веса, собранные под другую базовую архитектуру, могут загрузиться без ошибки и почти не дать видимого эффекта. Прогоните на новых весах один нарочито показательный prompt, убедитесь, что вывод сдвинулся, и только потом ставьте партию в очередь.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-lora/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"output_format": "jpeg",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
