Введение
Qwen Image Edit Spicy правит одно исходное изображение по одной инструкции на простом английском. Нет ни маски, ни выбора области, ни регулятора отклонения от оригинала: фраза — это всё управление, а защищено только то, что вы назвали.
Запрос — это image_url, prompt и необязательный seed; seed, равный 0, запрашивает случайную генерацию. Каждый запрос возвращает одно изображение.
Ключевые возможности и особенности
Ни маски, ни силы, ни инпейнтинга
Большинство редакторов заставляют выбрать область и степень изменения, прежде чем что-то поменять. Этот принимает фразу. Назовите, что меняется, назовите, что должно остаться, и отправьте. Отсутствие регулятора силы — осознанное решение: что сохранить, выражается словами, и так же потом проверяется правка.
Смелые смены одежды, без фильтров
Смена одежды, которую отказываются обрабатывать фильтрованные редакторы, здесь обычная инструкция, а не особый случай. Нет флага зрелости, который нужно включать, и нет другого эндпоинта, куда бы перенаправили запрос. Ваши формулировки в инструкции передаются так, как написаны.
Перепишите вывеску, не перерисовывая комнату
Поскольку модель унаследовала типографику линейки Qwen Image, она может менять текст, который уже есть в кадре: табличку на двери, меловую доску с меню, этикетку бутылки. Процитируйте текущую строку и нужную и укажите, что поза, кадрирование и цветокоррекция не меняются.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
image_url | Да | Публичная прямая ссылка на изображение, права на которое у вас. Не менее 1 символов |
prompt | Да | Одна инструкция с обеими половинами правки. Не менее 1 символов |
seed | Нет | Передайте тот же seed с тем же изображением и инструкцией, чтобы выборка между двумя правками осталась одинаковой и отличалось только то, что вы поменяли: это инструмент сравнен… |
Стоимость
$0.038 / изображение
Сценарии использования
Доработать присланный кадр
Используйте этот эндпоинт, когда существующая фотография должна остаться той же фотографией, а поменяться должно только одно. Отправьте её как image_url, назовите изменение и элементы, которые должны остаться, — позу, кадрирование, свет, цветокоррекцию — и сравните результат с исходником.
Инструкции, которые отклоняют другие редакторы
Смелые инструкции по одежде, которые отклоняют API редактирования с фильтрами, здесь выполняются как обычные правки. В запросе ничего не меняется: те же имена полей, тот же жизненный цикл задачи, тот же асинхронный опрос результата.
Смена наряда на утверждённом кадре
У вас уже есть портрет с удачной позой и светом. Замените наряд вечерним или более смелым образом без перегенерации сцены, чтобы лицо, комната и цветокоррекция сохранились и сет остался цельным.
Текстовые варианты на уже оплаченном снимке
Меняйте только слова на вывеске, табличке или этикетке, а фотографию оставляйте идентичной. Дешевле и гораздо последовательнее, чем генерировать всю сцену заново для каждого языка или каждой строки кампании.
Руководство по промптам и практические советы
Разместите исходник там, откуда его можно скачать
image_url должен быть публичной ссылкой для прямой загрузки — не страницей просмотрщика и не подписанным URL, который истечёт до запуска задачи. Исходник задаёт композицию и потолок качества всего прохода.
Пишите одну инструкцию, которая называет обе стороны правки
Скажите, что меняется и что должно остаться прежним, по одной фразе на каждое. Правка для этого эндпоинта получена из инструкции: «Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.»
Адаптируйте приложенный пример
Начните с опубликованного примера, указав в image_url общедоступный URL. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Keep the woman, the bed and the hotel room exactly as they are. Change her outfit to a black lace bodysuit with sheer black stockings, and change the brass door hanger text to read 'BACK AT MIDNIGHT'. Keep the same pose, framing, lighting and colour grade.
Точная инструкция, стоящая за правкой, показанной для этого эндпоинта: смена наряда плюс смена текста на дверной табличке, при этом поза, кадрирование, освещение и цветокоррекция прямо указаны как неизменные. Подставьте свой исходный кадр — image_url здесь заглушка, а не размещённый образец.
Проверьте результат, прежде чем повторять
Надёжный путь — одно изменение за вызов и явное перечисление того, что сохраняется: позы, кадрирования, света, цветокоррекции. Попросите сменить одежду и текст в одной инструкции — и одно из двух обычно «уплывёт». Образ хорошо держится при одной точечной правке и деградирует в длинных цепочках, поэтому правьте снова от оригинала, а не от предыдущего результата. Регулятора силы нет: если правка зашла слишком далеко, помогает более точная фраза, а не меньшее число.
Быстрый старт 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-spicy-edit/edit",
"input": {
"image_url": "https://example.com/reference.png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.
