Введение
Что делает этот эндпоинт
Qwen Image 2.1 Turbo Image Editing правит ваши исходные изображения по письменной инструкции и возвращает от одного до шести новых кадров на 8-шаговом чекпойнте Qwen Image 2.1 от Alibaba. Наши правки занимали от 26 до 59 секунд от начала до конца.
Входные данные
image_urls содержит от одного до десяти референсов — в том порядке, в котором вы называете их Image 1, Image 2 и так далее. prompt — инструкция. Не указывайте aspect_ratio, чтобы сохранить форму исходника примерно в 2K, либо задайте его вместе с resolution для фиксированного размера. num_outputs задаёт от одного до шести результатов, enable_prompt_expansion (по умолчанию выключено) и enable_thinking управляют переписыванием от Alibaba, а seed стабилизирует серию.
Контент
Фильтра на стороне платформы нет. При выключенном расширении правки, меняющие одежду или показывающие больше, возвращались как запрошено; при включённом та же инструкция возвращалась без изменений.
| Характеристика | Значение |
|---|---|
| Ввод | Изображение |
| Вывод | Изображение |
| Статус на SpicyAPI | Работает: text-to-image и редактирование изображений |
| Основа | Qwen Image 2.1: 8-шаговый ускоренный чекпойнт той же 7B-модели |
| Изображений за запрос | От 1 до 6, оплата за каждое возвращённое изображение |
| Цена | Одна цена за изображение на уровнях 1k, 1.5k и 2k; актуальная оценка — на этой странице |
| Соотношения сторон | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Размеры в 2K | 1:1 2048 × 2048, 16:9 2688 × 1536, 9:16 1536 × 2688, 4:3 2368 × 1760, 3:2 2496 × 1664, 2:3 1664 × 2496 |
| Редактирование | От 1 до 10 референсов; без соотношения сторон результат повторяет форму исходника примерно в 2K |
| Промпт | До 5 000 символов; негативного промпта нет, поэтому исключения пишите в сам промпт |
| Расширение промпта | По умолчанию выключено; при включении — переписывание direct или agent, с необязательным проходом thinking |
| Измеренное ожидание | В наших прогонах: 13–39 секунд для text-to-image, 26–59 секунд для правок |
| Политика контента | Без цензуры: фильтра на стороне платформы нет, флага возрастного ограничения нет |
| Открытые веса | Qwen/Qwen-Image-2.1-Turbo по Qwen Research License Agreement |
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Инструкция по правке, до 5 000 символов. Сначала скажите, что меняется, затем что должно остаться: лицо, волосы, поза, свет. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до десяти исходных изображений в том порядке, в каком вы на них ссылаетесь. Число референсов цену не меняет. Не менее 1 элементов · Не более 10 элементов |
aspect_ratio | Нет | Не указывайте — и результат сохранит форму исходника примерно в 2K. Задайте одну из пятнадцати форм, когда нужен фиксированный кадр, например 16:9 для двух людей рядом. |
resolution | Нет | 1k, 1.5k или 2k; используется, только когда задано соотношение сторон. Все уровни стоят одинаково за изображение. |
num_outputs | Нет | От одного до шести результатов по одной инструкции за запрос. Каждое возвращённое изображение тарифицируется. |
enable_prompt_expansion | Нет | По умолчанию выключено. По умолчанию: |
enable_thinking | Нет | Тратит на переписывание дополнительные рассуждения, но ждать приходится дольше. Работает только при включённом расширении промпта. По умолчанию: |
seed | Нет | Фиксирует розыгрыш, чтобы сравнивать по одному изменению за раз. Побайтово идентичное изображение не гарантируется. |
Стоимость
$0.014 / изображение
Сценарии использования
Работа с изображениями без цензуры
SpicyAPI не ставит перед Turbo никакого фильтра контента. При выключенном расширении промпта наши тесты прошли так, как написаны, на каждом уровне контента, который мы прогоняем, от «Мягкий» до «Максимальный», одинаково для женщин и мужчин. На уровне «Очень сильный» прошёл один из двух запусков; второй остановился, не дойдя до конца запроса.
Много черновиков ради одного удачного
Восемь шагов и до шести изображений за вызов — это дешёвый веер вариантов. Переберите одежду, позу и свет в одном запросе, оставьте удачный кадр и тратьте правки уже на него.
Один персонаж на всю серию
Создайте персонажа, затем отправьте кадр обратно как референс и меняйте платье, комнату или свет отдельными проходами. Каждая правка отталкивается от утверждённого кадра, а не от нового броска кубика, поэтому лицо остаётся одним и тем же во всей серии.
Пары из двух портретов
Отправьте два портрета как Image 1 и Image 2 и опишите сцену, в которой они вместе. В нашем тесте мужчина и женщина, снятые по отдельности, оказались смеющимися рядом на крыше в сумерках, и оба остались узнаваемыми.
Плакаты и типографика
Turbo аккуратно набирает короткие заголовки. Берите текст в кавычки, говорите, где он стоит, и описывайте стиль плаката: наш кабаре-плакат вернулся с обеими строками без единой ошибки.
Предметные кадры и обложки
Одна цена до 2K и шесть изображений за вызов подходят для превью, обложек и предметных съёмок, где нужно несколько кадров одной идеи и полноразмерный мастер, который можно обрезать.
Руководство по промптам и практические советы
Для взрослых задач не включайте расширение промпта
Расширение передаёт ваш промпт переписчику Alibaba до того, как рисуется изображение, а переписчик смягчает бриф без фильтров: в наших тестах он смягчил изображение уровня «Сильный», превратил сцену уровня «Очень сильный» в сцену, где это лишь намекается, и вернул правку, которая просила пойти дальше, ничего не изменив. При выключенном расширении те же промпты возвращались как написано. Здесь оно выключено по умолчанию; оставьте так, если вам не нужно переписывание.
Для коротких бытовых промптов включайте его
Короткая заявка из шести слов превращается в более полную сцену, если расширение включено. direct переписывает за один проход и подходит для большинства промптов; agent переписывает в несколько шагов и даёт более тонкий результат. Режим thinking тратит на это переписывание дополнительные рассуждения и добавляет время; пока расширение выключено, он ничего не делает.
Берите 2K — он стоит столько же
Все уровни стоят одинаково за изображение, поэтому по умолчанию выбран 2K — это разумный выбор. Переходите на 1k, только если нужен файл поменьше или чуть более быстрый ответ.
Просите сразу несколько изображений
Задайте
num_outputsот 1 до 6, чтобы получить за один вызов варианты одного промпта. Каждое возвращённое изображение тарифицируется, так что шесть изображений стоят в шесть раз больше одного. Это самый дешёвый способ найти понравившуюся позу или композицию, прежде чем переходить к правкам.В правках сначала пишите изменение, затем список неизменного
Напишите одну вещь, которая меняется, а затем всё, что должно остаться: «Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression.» (сменить её тёмное бархатное платье на алое атласное с открытой спиной; сохранить лицо, волосы и выражение). Называйте референсы по номерам. В нашем тесте с двумя портретами фраза «the man from Image 1 and the woman from Image 2» сохранила узнаваемость обоих лиц в одном кадре.
Берите в кавычки слова, которые должны появиться
Точную формулировку берите в кавычки и говорите, где она стоит. В нашем тесте с плакатом «VELVET HOUR» вверху и «LATE SHOW · FRIDAYS 11 PM» внизу обе надписи вернулись буква в букву. Делайте каждую строку короткой и проверяйте её в полном размере перед публикацией.
Пишите промпт в фиксированном порядке
Объект, одежда, поза, свет, объектив и палитра — простыми предложениями. Называйте источник света и его направление (одна тёплая лампа слева, залитое дождём стекло за её спиной), а не слово о настроении. При выключенном расширении Turbo рисует то, что вы написали, и сам пробелы не заполняет.
Введение
Qwen Image 2.1 Turbo Image Editing меняет существующее изображение по инструкции обычными словами. Команда Qwen из Alibaba выпустила Turbo с открытыми весами 9 октября 2026 года и создала его для продолжения работы через правки на естественном языке — от добавления аксессуара до смены сцены — за 8 шагов шумоподавления на той же 7B-архитектуре, что у Qwen Image 2.1.
На SpicyAPI он уже работает. Один запрос принимает от одного до десяти референсов и возвращает от одного до шести результатов по одной цене за изображение, а перед моделью нет фильтра контента. Все примеры на этой странице созданы на Turbo с показанными промптами.
Выберите режим по тому, что у вас есть
| Исходный материал | Режим |
|---|---|
| Одно или несколько изображений для изменения | Qwen Image 2.1 Turbo Image Editing |
| Письменное задание и больше ничего | Qwen Image 2.1 Turbo Text to Image |
Что мы измерили
Скорость
От 26 до 59 секунд на правку от начала до конца в наших прогонах.
Форма
Без соотношения сторон портрет 2:3 вернулся кадром 2:3 примерно в 2K (1680 × 2512). Когда нужен фиксированный размер, задайте соотношение сторон.
Контент
При выключенном расширении промпта (по умолчанию) правки на каждом уровне контента, который мы тестировали, вернулись так, как просили, — для портрета женщины и мужчины. При включённом расширении запрос на большее дважды вернул нетронутый исходник и был списан как выполненный.
Два референса
Мужчина и женщина, снятые по отдельности, вернулись рядом на одной крыше, оба узнаваемы, а её наряд изменён, как просили.
Turbo или правка в Qwen Image 2.1
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Шаги шумоподавления | 8 | 40 |
| Результатов за запрос | От 1 до 6 | 1 |
| Цена за дополнительный референс | Нет | Каждый добавляет к цене |
| Маска для локальных правок | Нет | Да |
| Формат вывода | PNG | JPEG, PNG или WebP |
| Фильтр контента | Нет | Нет |
Берите Turbo для быстрых цепочек правок и работы с несколькими референсами по одной цене. Берите Qwen Image 2.1, когда нужна маска.
Руководство по промптам и советы
Сначала изменение, потом то, что остаётся
«Change her dark velvet dress into a backless crimson satin gown; keep her face, hair and expression» (сменить её тёмное бархатное платье на алое атласное с открытой спиной; сохранить лицо, волосы и выражение) — это правка. «Make it better» (сделай лучше) — это новый бросок кубика.
Назовите каждый референс
Модель сама не назначает роли референсам. Скажите, какое изображение — человек, какое — одежда, а какое — место.
Не включайте расширение
Переписывание может выбросить вашу инструкцию и вернуть исходник. Когда оно выключено, инструкция доходит до модели как написана.
Одно изменение за проход
Одно изменение легко оценить. Когда их пять сразу, трудно понять, какая инструкция сдвинула лицо или руки.
После нескольких правок возвращайтесь к оригиналу
В длинной цепочке правок лица могут «уплывать». Когда детали начнут смещаться, вернитесь к первому утверждённому кадру.
Быстрый старт 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-turbo/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# 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.
