Введение
Что делает этот эндпоинт
Qwen Image 2.1 Pro Image Editing правит ваши исходные изображения по письменной инструкции и возвращает от одного до шести новых кадров на размещённом уровне Pro модели Alibaba Qwen Image 2.1. Наши правки занимали от 39 до 48 секунд от начала до конца.
Входные данные
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, в виде размещённого уровня Pro от Alibaba |
| Изображений за запрос | От 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 |
| Измеренное ожидание | От 14 до 43 секунд для text-to-image, от 39 до 48 секунд для правок, по нашим прогонам |
| Политика контента | Без цензуры: фильтра на стороне платформы нет, флага зрелости нет |
| Веса | Не опубликованы; Alibaba предлагает Pro как размещённый API |
Ключевые возможности и особенности
Заголовок, написанный верно с первого раза
Берите слова в кавычки и указывайте, где они стоят. «AFTER DARK» вверху и небольшая строка обложки под ним вернулись буква в букву на обоих изображениях запроса.
Два портрета, один стол при свечах
Мужчина и женщина, снятые по отдельности и названные Image 1 и Image 2, оказываются за одним столом на террасе виноградника: оба лица по-прежнему узнаваемы, а её платье изменено, как просили.
Pro или Turbo — без переписывания ни строки
На SpicyAPI Pro и Turbo читают одни и те же поля, поэтому промпт, работающий в одной модели, можно без изменений отправить в другую. Набрасывайте быстро в Turbo и оставляйте важные кадры для Pro — или наоборот.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Инструкция правки, до 5 000 символов. Сначала скажите, что меняется, затем что должно остаться: лицо, волосы, поза, свет. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до десяти исходных изображений в том порядке, в котором вы на них ссылаетесь. Число референсов на цену не влияет. Не менее 1 элементов · Не более 10 элементов |
aspect_ratio | Нет | Не указывайте — и результат сохранит форму исходника примерно в 2K. Задайте одну из пятнадцати форм, когда нужен фиксированный кадр, например 3:2 для двух людей за одним столом. |
resolution | Нет | 1k, 1.5k или 2k; используется только при заданном соотношении сторон. Все уровни стоят одинаково за изображение. |
num_outputs | Нет | От одного до шести результатов по одной инструкции в одном запросе. Каждое возвращённое изображение тарифицируется. |
enable_prompt_expansion | Нет | По умолчанию выключено, поэтому ваша инструкция доходит до модели в исходном виде. Если включить, Alibaba сначала её перепишет, и более смелый запрос может смягчиться. По умолчанию: |
enable_thinking | Нет | Тратит дополнительные рассуждения на переписывание ценой более долгого ожидания. Работает только при включённом расширении промпта. По умолчанию: |
seed | Нет | Стабилизирует бросок, чтобы сравнивать по одному изменению. Не гарантирует пиксельно идентичное изображение. |
Стоимость
$0.036 / изображение
Сценарии использования
Работа с изображениями без цензуры
SpicyAPI не ставит перед Pro фильтр контента. При выключенном расширении промпта наши тесты вернулись как написано на каждом уровне интенсивности, который мы проверяли, — от Мягкого до Максимального, с женскими и мужскими персонажами.
Обложки и плакаты с точным текстом
Alibaba называет у Pro улучшенную типографику. Возьмите в кавычки заголовок и строку обложки, скажите, где каждая стоит, и опишите фотографию: наша обложка журнала вернулась с обеими строками, написанными точно, на обоих изображениях запроса.
Один персонаж на всю серию
Сгенерируйте персонажа, затем отправьте кадр обратно как референс и меняйте наряд, комнату или свет отдельными проходами. Каждая правка начинается с утверждённого вами кадра, а не с нового броска, поэтому лицо сохраняется на протяжении серии.
Пары из двух портретов
Отправьте два портрета как Image 1 и Image 2 и опишите общую для них сцену. В нашем тесте мужчина и женщина, снятые по отдельности, оказались за одним столом при свечах на террасе виноградника, оба по-прежнему узнаваемы.
Атмосферные портреты и свет
Alibaba указывает на портретный свет и мелкую детализацию как на сильные стороны Pro. Назовите один источник света и куда он падает — штормовая лампа, высокое окно, бра — и кадр строится вокруг него.
Много черновиков ради одного удачного
До шести изображений за вызов по одной цене — недорогой набор вариантов. Исследуйте одежду, позу и свет в одном запросе, оставьте сработавший кадр и тратьте правки на него.
Руководство по промптам и практические советы
Когда важна формулировка, держите расширение промпта выключенным
Расширение передаёт ваш промпт переписчику Alibaba до того, как рисуется изображение, и эта переработка может смягчить смелый запрос. Здесь оно выключено по умолчанию, и все контентные тесты, которые мы проводили с выключенным расширением, вернулись как написано. В нашем единственном прогоне Pro с включённым расширением запрос, который официальное приложение заблокировало бы, всё же прошёл, но держите его выключенным, когда важна точная формулировка.
Для коротких бытовых промптов включайте его
Задание из шести слов получает более развёрнутую сцену, когда расширение включено. direct переписывает за один проход и подходит большинству промптов; agent переписывает в несколько шагов ради более тонкого результата. Режим thinking тратит дополнительные рассуждения на это переписывание и добавляет время; при выключенном расширении он ничего не делает.
Берите 2K — он стоит столько же
Все уровни стоят одинаково за изображение, поэтому 2K — значение по умолчанию и разумный выбор. Переходите на 1k, только когда нужен файл поменьше или чуть более быстрый ответ.
Просите сразу несколько изображений
Задайте
num_outputsот 1 до 6, чтобы получить за один вызов варианты одного промпта. Каждое возвращённое изображение тарифицируется, так что шесть изображений стоят в шесть раз больше одного. Это самый дешёвый способ найти понравившуюся позу или композицию до начала правок.В правках сначала пишите изменение, затем список неизменного
Сначала напишите единственное, что меняется, потом всё, что должно остаться: «Замени её бархатное платье на вечернее платье цвета слоновой кости; сохрани лицо, волосы и выражение». Ссылайтесь на референсы по номеру. В нашем тесте с двумя портретами «мужчина с изображения 1 и женщина с изображения 2» за столом при свечах оба лица в одном кадре узнавались.
Берите в кавычки слова, которые должны появиться
Точные слова помещайте в кавычки и указывайте, где они стоят. Наша обложка журнала — «AFTER DARK» вверху и «THE SILK ISSUE · NO. 07» мелкими буквами ниже — вернулась буква в букву. Делайте каждую строку короткой и проверяйте её в полном размере перед публикацией.
Пишите промпт в фиксированном порядке
Объект, одежда, поза, свет, объектив и палитра — простыми предложениями. Называйте источник света и его направление (одна масляная лампа слева, вращающийся луч за её спиной), а не слово о настроении. При выключенном расширении Pro рисует то, что вы написали, и не заполняет пробелы за вас.
Введение
Qwen Image 2.1 Pro Image Editing меняет существующее изображение по инструкции обычными словами. Pro — размещённый уровень Qwen Image 2.1 от Alibaba, объединяющей генерацию и редактирование в одной модели; Alibaba называет редактирование с числом референсов до десяти, локальные правки, сохраняющие людей и предметы нетронутыми, а также улучшенный портретный свет и мелкую детализацию.
На SpicyAPI он уже работает. Один запрос принимает от одного до десяти референсов и возвращает от одного до шести результатов по одной цене за изображение, а перед моделью нет фильтра контента. Все примеры на этой странице созданы на Pro с показанными промптами.
Выберите режим по тому, что у вас есть
| Исходный материал | Режим |
|---|---|
| Одно или несколько изображений для изменения | Qwen Image 2.1 Pro Image Editing |
| Письменное задание и больше ничего | Qwen Image 2.1 Pro Text to Image |
Что мы измерили
Скорость
От 39 до 48 секунд на правку от начала до конца в наших прогонах, включая два результата по двум референсам за один вызов.
Форма
Без соотношения сторон портрет 2:3 вернулся кадром 2:3 примерно в 2K (1664 × 2496). Когда нужен фиксированный размер, задайте соотношение сторон.
Контент
При выключенном расширении промпта, которое включено по умолчанию, каждая протестированная правка вернулась как запрошено, на всех пяти уровнях интенсивности — от Мягкого до Максимального. Ни одна правка не была отклонена.
Два референса
Мужчина и женщина, снятые по отдельности, вернулись рядом за одним столом при свечах, оба узнаваемы, а её наряд изменён, как просили.
Правка в Pro или в Turbo
| Pro | Turbo | |
|---|---|---|
| Что это | Размещённый уровень Pro от Alibaba | 8-шаговый чекпойнт |
| Веса | Не опубликованы | Открытые, Qwen Research License |
| Результатов за запрос | От 1 до 6 | От 1 до 6 |
| Цена за дополнительный референс | Нет | Нет |
| Цена за изображение | Выше | Ниже |
| Фильтр контента | Нет | Нет |
Запрос один и тот же, так что можно выполнить одну инструкцию в обеих моделях и оставить результат, который нравится больше.
Руководство по промптам и советы
Сначала изменение, потом то, что остаётся
«Замени её бархатное платье на вечернее платье цвета слоновой кости; сохрани лицо, волосы и выражение» — это правка. «Сделай лучше» — это новый запуск.
Называйте каждый референс
Модель сама не назначает референсам роли. Скажите, какое изображение — человек, какое — одежда, а какое — место.
Оставляйте расширение выключенным
Переписывание может смягчить вашу инструкцию до того, как её увидит модель. Когда оно выключено, инструкция доходит до модели как написано.
Одно изменение за проход
Одно изменение легко оценить. Пять сразу мешают понять, какая инструкция сдвинула лицо или руки.
После нескольких правок возвращайтесь к оригиналу
Лица могут дрейфовать в длинной цепочке правок. Возвращайтесь к первому утверждённому кадру, когда детали начинают смещаться.
Быстрый старт 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-pro/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.
