Введение
Qwen Image 2 Редактирование изображения принимает ровно одно референсное изображение и инструкцию и возвращает один отредактированный результат: с новым светом, в другом стиле, в другой одежде или с добавленной надписью — так, как описано в промпте.
Qwen Image 2 — универсальная модель изображений от Alibaba: промпт до 800 символов, который читается напрямую на китайском или английском, пять соотношений сторон в режиме текст в изображение и эндпоинт правки, который переделывает один референс в выбранном вами формате. Один запрос — одно изображение; необязательный seed фиксирует генерацию, пока вы сравниваете варианты.
Выберите режим Qwen Image 2 по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменная арт-дирекция или дизайн-бриф | Qwen Image 2 Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Qwen Image 2 Редактирование изображения |
Ключевые возможности и особенности
Промпты на двух языках
Qwen Image 2 напрямую читает промпты на китайском и английском, поэтому команда может работать на том языке, на котором бриф звучит яснее всего, и не переписывать его при передаче.
Письменная правка одного присланного изображения
Режим правки начинается с одного присланного изображения и письменной инструкции. Выбирайте его, когда образ или композиция уже есть, а проверять нужно намеренное изменение, а не новую идею.
Две чётко разделённые отправные точки
Текст в изображение нужен, чтобы построить новую сцену по арт-дирекции; правка — чтобы доработать исходный кадр. Если сначала выбрать исходный материал, бриф на правку не будут оценивать как генерацию с нуля.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 800 символов с описанием результата, а не исходника. Скажите, что должно остаться неизменным и что меняется; всё, что не сказано, может уплыть. Не менее 1 символов · Не более 800 символов |
image_urls | Да | Ровно один публично доступный URL в формате jpeg, png или webp на изображение, права на которое у вас есть. Не менее 1 элементов · Не более 1 элементов |
aspect_ratio | Нет | По умолчанию 1:1, также 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 и 21:9. Результат не повторяет форму исходника, поэтому задавайте соотношение своей фотографии, когда важны её пропорции. |
seed | Нет | Уберите — и каждый вызов даст новый прогон; задайте — и две формулировки одной правки можно сравнить на одном прогоне. |
Стоимость
$0.035 / изображение
Сценарии использования
Доработать присланный кадр
Используйте этот режим, когда существующее фото должно задать объект, композицию или стиль. Передайте его единственным элементом image_urls, напишите, что меняется и что должно остаться прежним, и сравните результат с исходником в том размере, в котором он будет использоваться.
Продукт в новой сцене
Пришлите фото продукта и опишите обстановку, в которой он должен оказаться, включая свет, который должен на него падать. Один вызов — один кадр. Если обстановка должна прийти со второй фотографии, используйте модель правки, которая принимает несколько референсов.
Двуязычный продакшн кампании
Адаптируйте утверждённый ключевой визуал для другого рынка: попросите надпись на свободной поверхности и впишите её в промпт ровно так, как она должна читаться, на китайском или английском. Ограничьтесь короткой строкой: вывески и длинные тексты — задача линейки Qwen Image 3.0.
Персонажи и костюмы
Оставьте человека с одной фотографии и опишите словами новую вещь, включая ткань и блеск. Задайте aspect_ratio по форме фото — по умолчанию стоит 1:1, — чтобы результат не превратился в квадрат, о котором вы не просили.
Руководство по промптам и практические советы
Сначала формат, потом текст
Форму результата задаёт aspect_ratio, а не исходник. По умолчанию это 1:1, доступно восемь соотношений, в том числе 3:2, 2:3 и 21:9; выберите то, что соответствует вашей фотографии, до того как писать инструкцию.
800 символов — на одну цельную сцену
Описывайте результат, а не исходник. Сначала скажите, что должно остаться прежним, затем — что меняется, а остаток потратьте на новые декорации и свет: всё, что не сказано, может уплыть.
Адаптируйте приложенный пример
Начните с опубликованного примера и замените творческое направление, сохранив контракт входных данных этого режима.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Перенос сцены по одному референсу: женщина и халат сохраняются, неоновый бар описан словами, а подгонка света указана явно. Изображение должно быть вашим — URL здесь заглушка, а не размещённый образец.
Проверьте результат, прежде чем повторять
Регулятора силы здесь нет, а референс принимается ровно один — второй отклоняется ещё до того, как запрос покинет платформу. aspect_ratio по умолчанию равен 1:1 и не следует за исходником, поэтому вертикальное фото вернётся квадратным, если не задать формат. Сколько останется от исходника, решает точность инструкции. Зафиксируйте seed, чтобы сравнить две формулировки одной и той же правки на одинаковой генерации.
Быстрый старт 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/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"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.
