Введение
Qwen Image 3.0 Pro Редактирование изображения правит от одного до трёх референсных изображений по инструкции. С одним референсом это хирургическая правка — анонс на обложке, предмет одежды, свет. С двумя или тремя — сведение, если в промпте сказано, что даёт каждый источник.
Qwen Image 3.0 Pro — детальный уровень линейки изображений Qwen от Alibaba: промпт до 5000 символов, восемь соотношений сторон, уровень 1K или 2K и правка по одному–трём референсам. Для кадров, которые идут в работу, без цензуры.
Выберите режим Qwen Image 3.0 Pro по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменная арт-дирекция или дизайн-бриф | Qwen Image 3.0 Pro Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Qwen Image 3.0 Pro Редактирование изображения |
Ключевые возможности и особенности
Композиция, которая учитывает текст
Qwen Image 3.0 Pro подходит для визуальных концепций, где предоставленный текст, композицию и обработку изображения нужно продумывать вместе. Считайте сгенерированные надписи черновиком дизайна и вычитывайте их перед публикацией.
Новая композиция и доработка исходника — разные задачи
Используйте «текст в изображение», чтобы построить визуал по письменному брифу. Используйте редактирование изображения, когда существующий кадр задаёт образ, компоновку или материал, которые нужно сохранить при конкретном изменении.
Сначала иерархия, потом декор
Для постеров, упаковки и концепций кампаний сначала определите иерархию сообщений и фокусную зону. Привлекательный результат всё равно не решает задачу, если утверждённый текст или данные о продукте переданы неверно.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Назовите изменение и назовите то, что обязано остаться идентичным: всё неупомянутое может быть перерисовано. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одной до трёх публично доступных ссылок на изображения, права на которые у вас. Порядок значим: prompt называет их первым, вторым и третьим, а роли никогда не выводятся сами. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | Относится к результату, а не к источникам, поэтому референс другой формы вернётся перекроенным. Задавайте его осознанно, когда исходное кадрирование обязано уцелеть. |
resolution | Нет | 1k или 2k, по умолчанию 2k. Это выбор ступени, который меняет цену; каждое референсное изображение в |
num_outputs | Нет | Всегда 1: одна отредактированная картинка на запрос. |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
negative_prompt | Нет | До 2000 символов исключений. Здесь он полезнее всего против артефактов, которые провоцирует правка: швов на одежде, остатков букв, задвоенных украшений. Не более 2000 символов |
seed | Нет | Зафиксируйте, чтобы сравнить две формулировки одной инструкции на одном прогоне; уберите, когда нужен настоящий разброс. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.04 / изображение |
| $0.075 / изображение |
Сценарии использования
Доработать присланный кадр
Используйте этот режим, когда в результат должны перейти от одного до трёх утверждённых кадров. Перечислите их в image_urls в порядке, в каком их называет промпт, и дайте каждому роль — лицо с первого, одежда со второго, — потому что роли никогда не выводятся сами.
Обложки журналов и редакционные съёмки без цензуры
Сохраните утверждённую обложку и меняйте по одному элементу за проход: анонс, одежду или свет. Именно при смене стиля и текста в одном вызове лица начинают «плыть», поэтому разнесите это на два запроса.
Макеты афиш и наружной рекламы
Возьмите утверждённый кадр афиши и замените строку даты или юридическую плашку для следующего тиража. Процитируйте старую и новую строку, оставьте aspect_ratio по форме кадра и опишите всё остальное как неизменное.
Макеты упаковки и этикеток
Отправьте рендер продукта и замените этикетку: процитируйте название бренда и короткий слоган, укажите, на какой поверхности они находятся, и используйте negative_prompt против остатков надписей со старой этикетки.
Руководство по промптам и практические советы
Выберите форму обложки и оставайтесь на 2k
Для обложек и афиш выбирайте 3:4 или 2:3; кадр компонуется под эту форму, а не вырезается внутри неё. Для всего, где есть текст, оставляйте разрешение 2k — на 1k преимущество этого уровня исчезает.
Цитируйте каждую строку и указывайте, где она стоит
При правке текста процитируйте старую и новую строку и укажите позицию, а затем назовите элементы, которые должны остаться нетронутыми, например название журнала. Всё, что инструкция не упоминает, может быть перерисовано.
Адаптируйте приложенный пример
Начните с опубликованного примера с aspect_ratio: 3:4 и resolution: 2k. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Keep the portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.
Правка текста по одному референсу: обе строки процитированы, а название журнала явно защищено. Подставьте собственную обложку — значение image_urls здесь заглушка, а не размещённый образец.
Проверьте результат, прежде чем повторять
Сведение работает, когда промпт назначает роль каждому референсу; при трёх источниках без названных ролей получается смесь, которую никто не просил. Замена текста на месте требует процитировать и старую, и новую строку. Лица «плывут», если в одном вызове менять и стиль, и текст, поэтому разделите это на два прохода.
Быстрый старт 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-3.0-pro/edit",
"input": {
"aspect_ratio": "1:1",
"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.
