Введение
Qwen Image 3.0 Редактирование изображения принимает от одного до трёх референсных изображений и инструкцию и возвращает отредактированный результат. С одним референсом это точечная правка; с двумя или тремя — сведение: лицо с одного, одежда или фон с другого, при условии, что в промпте сказано, что откуда брать.
Qwen Image 3.0 — модель изображений Alibaba с упором на отрисовку текста: промпт до 5000 символов, восемь соотношений сторон, уровень 1K или 2K и эндпоинт правки, который читает от одного до трёх референсов. Без цензуры и без флагов.
Выберите режим Qwen Image 3.0 по исходному материалу
| Исходный материал | Режим |
|---|---|
| Письменная арт-дирекция или дизайн-бриф | Qwen Image 3.0 Текст в изображение |
| Утверждённое исходное изображение, которое нужно доработать | Qwen Image 3.0 Редактирование изображения |
Ключевые возможности и особенности
Композиция, которая учитывает текст
Qwen Image 3.0 подходит для визуальных концепций, где предоставленный текст, композицию и обработку изображения нужно продумывать вместе. Считайте сгенерированные надписи черновиком дизайна и вычитывайте их перед публикацией.
Новая композиция и доработка исходника — разные задачи
Используйте «текст в изображение», чтобы построить визуал по письменному брифу. Используйте редактирование изображения, когда существующий кадр задаёт образ, компоновку или материал, которые нужно сохранить при конкретном изменении.
Сначала иерархия, потом декор
Для постеров, упаковки и концепций кампаний сначала определите иерархию сообщений и фокусную зону. Привлекательный результат всё равно не решает задачу, если утверждённый текст или данные о продукте переданы неверно.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | До 5000 символов. Скажите, что меняется и что обязано остаться идентичным; всё неупомянутое может быть перерисовано. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одной до трёх публично доступных ссылок на изображения, права на которые у вас. Не менее 1 элементов · Не более 3 элементов |
aspect_ratio | Нет | Применяется к результату, а не к источникам. |
resolution | Нет | 1k или 2k, по умолчанию 2k. Это выбор ступени, который меняет цену; каждое референсное изображение в |
num_outputs | Нет | Всегда 1: одна отредактированная картинка на запрос. |
enable_prompt_expansion | Нет | У этого семейства включено по умолчанию. Тощие брифы оно дополняет, подробные переписывает, поэтому выключайте, как только prompt стал точным описанием кадра. По умолчанию: |
negative_prompt | Нет | До 2000 символов исключений. В правках он полезнее всего против артефактов, которые провоцирует источник: швов на краю одежды, задвоенных украшений, остатков букв. Не более 2000 символов |
seed | Нет | На этапе поиска не указывайте. Зафиксируйте, чтобы сравнить две формулировки одной инструкции на одном и том же прогоне. |
Стоимость
| Спецификация | Стоимость |
|---|---|
| $0.03 / изображение |
| $0.03 / изображение |
Сценарии использования
Доработать присланный кадр
Используйте этот режим, когда от одного до трёх существующих изображений должны задать объект, компоновку или материал. Перечислите их в image_urls в том порядке, в каком их называет промпт, — первое, второе, третье — и укажите, что даёт каждое.
Наборы персонажей и модные серии
Сохраните персонажа из утверждённого кадра и меняйте по одной детали на запрос: одежду, свет или позу. Фиксируйте seed, когда сравниваете две формулировки одной и той же правки, чтобы разницу давала не генерация.
Варианты с локализованным текстом
Отправьте утверждённый кадр в эндпоинт правки и поменяйте только слова на вывеске. Поза, одежда, свет и цветокоррекция описаны как неизменные, так что вариант отличается текстом, а не всем кадром.
Сцены для гостиничного бизнеса и декора
Отправьте утверждённый кадр номера или бара и добавьте или замените надписи: табличку на дверь, меловую доску с меню, неоновую строку. Процитируйте новый текст, а если вывеска уже есть, процитируйте и прежнюю строку.
Руководство по промптам и практические советы
Сначала формат и уровень
aspect_ratio задаёт форму результата, а не исходников: референс другой формы вернётся переформатированным, поэтому подбирайте формат осознанно, если исходное кадрирование должно сохраниться. Для всего, где есть текст, оставляйте разрешение 2k; каждый референс к тому же увеличивает стоимость.
Опишите сцену и процитируйте текст дословно
Сначала скажите, что должно остаться прежним, затем — что меняется; всё, что не упомянуто, может быть перерисовано. При правке текста цитируйте и старую, и новую строку. negative_prompt принимает до 2000 символов и помогает против остатков надписей и задвоенных украшений.
Адаптируйте приложенный пример
Начните с опубликованного примера с aspect_ratio: 3:4 и resolution: 2k. Замените объект и творческое направление, сохранив контракт входных данных этого режима.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
Надпись на поверхности, которая не ровная и не чистая: запотевшее стекло, где каждый штрих должен стереть конденсат и открыть тёмное стекло, с маленькими подтёками на концах. Инструкция ограничивает правку свободной областью слева от отражения и требует оставить всё остальное на месте. Подставьте свой кадр — 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-3.0/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.
