Введение
Qwen Image 2.1 Image Editing переписывает от одного до десяти исходных изображений по письменной инструкции и возвращает один новый кадр. Команда Qwen в Alibaba открыла веса модели 21 сентября 2026 года; этот эндпоинт заработал здесь в тот же день.
Он работает без фильтра контента и без флага «для взрослых». В приёмочном тестировании мы провели исходный кадр без цензуры через наши инструкции: модель не переодела героиню, ничего не заблюрила и не отступила к более безопасной композиции — то есть избежала ровно того провала, из-за которого большинство эндпоинтов редактирования бесполезны для работы без цензуры.
Выберите режим Qwen Image 2.1 по исходному материалу
| Исходный материал | Режим |
|---|---|
| От одного до десяти исходных изображений | Qwen Image 2.1 Редактирование изображения |
| Только письменный бриф | Qwen Image 2.1 Текст в изображение |
| Исходники плюс ваши собственные веса LoRA | Qwen Image 2.1 LoRA Редактирование изображения |
Ключевые возможности и особенности
Десять референсов в одном запросе
Большинство эндпоинтов редактирования берут один источник или три. Этот читает до десяти — именно это делает последовательную серию практичной: удержите кадр, который задал персонажа, добавьте референс с нарядом, добавьте референс с локацией и меняйте по одной переменной за прогон.
Источник остаётся таким, каким его прислали
Эндпоинт, который тихо одевает героя, хуже того, который отказывает: он берёт деньги за не ту картинку. Мы подали сюда источник без цензуры с инструкцией оставить его как есть и добавить новые элементы — вернулось ровно это, со всеми названными элементами на месте.
Каждый референс тарифицируется, поэтому смета следует за запросом
Добавление источников поднимает стоимость линейно, а списывается та смета, что показана до отправки. Запрос с десятью источниками стоит в несколько раз дороже запроса с одним на том же уровне — повод отправлять работающие референсы и отбрасывать остальные.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Негативного промпта в этом семействе нет, поэтому исключения тоже идут сюда: назовите, что в кадре, а затем прямо скажите, чего в нём быть не должно. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до десяти референсов. Роли модель сама не назначает, поэтому назовите в prompt, что вносит каждый источник: где человек, где обстановка, где одежда. Не менее 1 элементов · Не более 10 элементов |
mask_url | Нет | Необязательное чёрно-белое изображение, которое переводит правку в локальный режим: белое — область, которая перерисовывается, чёрное остаётся как есть, а мягкий край в нескольк… |
aspect_ratio | Нет | Собирает кадр до генерации, а не обрезает после, поэтому берите форму, в которой будете публиковать. Пятнадцать вариантов: от полос 3:1 и 21:9 до колонок 1:3 и 9:21. |
resolution | Нет | Уровень, задающий размер вывода и цену: 1k — значение по умолчанию и самый дешёвый уровень, 1.5k находится посередине, на 2k держатся фактура кожи, волосы и плетение ткани. |
enable_prompt_expansion | Нет | По умолчанию включено: перед генерацией промпт переписывается в более подробное описание сцены. Выключите, чтобы ваша формулировка использовалась как есть. По умолчанию: |
background | Нет | По умолчанию opaque. |
output_format | Нет | По умолчанию JPEG. PNG — когда кадр уходит в композитинг, WebP — когда он сразу отправляется на страницу. |
seed | Нет | Стабилизирует выборку, чтобы серия держалась в одном регистре. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.036 / изображение |
| $0.048 / изображение |
| $0.072 / изображение |
Сценарии использования
Единая внешность персонажа внутри набора
Держите один утверждённый кадр как референс внешности и перезапускайте его с новой инструкцией для каждого изображения. Это заметно стабильнее надежды, что лицо воспроизведёт seed.
Сборка сцены вокруг готовой фигуры
Начните с уже имеющейся фигуры и добавьте второго героя, ограничение движения, обстановку или следы. Инструкции выполняются буквально.
Замена одежды и обстановки
Два референса — один на человека, второй на одежду или комнату — и prompt, который говорит, где что.
Подъём удачного кадра прямо в контексте
Перезапустите кадр с 1k как правку на 2k с инструкцией сохранить композицию, когда нужна деталь, но не перегенерация всей сцены.
Руководство по промптам и практические советы
Назовите вклад каждого референса
Роли модель не выводит сама. «Первое изображение — женщина, второе — комната, в которой она стоит» — вот разница между правкой и смешиванием.
Скажите, что меняться не должно
Негативного промпта здесь нет, поэтому защиты идут в основную инструкцию. «Оставь её ровно как в источнике, ничего не добавляй к одежде» — это та самая фраза, которая не даёт модели прикрыть героя, которого она считает нужным прикрыть.
Отправляйте меньше референсов, но лучше
С одного чистого источника внешность держится хорошо и плывёт по мере их накопления. А поскольку каждый референс ещё и прибавляет к цене, меньше обычно означает и дешевле, и резче.
Смотрите на смету, а не только на уровень
На этом эндпоинте число референсов двигает цену не меньше, чем уровень разрешения. Смета до отправки — источник истины: прочитайте её, прежде чем послать запрос с десятью источниками.
Быстрый старт 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/edit",
"input": {
"aspect_ratio": "1:1",
"background": "opaque",
"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.

















