Введение
Wan 2.7 Pro Редактирование изображения перерабатывает присланные изображения с направленным изменением. Используйте его, когда в исходнике есть детали, которые должны остаться узнаваемыми, а меняется локальное или стилистическое решение.
Выберите режим Wan 2.7 Pro по исходному материалу
| Что у вас есть в начале | Режим |
|---|---|
| письменный визуальный бриф | Wan 2.7 Pro Текст в изображение |
| изображение, которому нужно направленное изменение | Wan 2.7 Pro Редактирование изображения |
Ключевые возможности и особенности
До 4K на text-to-image
Text-to-image здесь по умолчанию работает в 2k, около 4 мегапикселей, и доходит до 4k, около 16 мегапикселей, там где стандартное семейство останавливается на 2k. Image-to-image работает в 2k. В этом разделении и смысл: берите 4k, когда генерируете главный кадр, который будут кадрировать или печатать, а не когда перекрашиваете пэкшот.
Свеча, кожа и мазок кисти
Второй кадр на этой странице — живописный интерьер: фигура за подсвеченной ширмой, одна свеча и бокал вина на лаковом столике. Мягкое угасание света, видимая фактура мазка и лицо, читаемое в таком размере, первыми рассыпаются на маленьком холсте — ради них крупный и нужен.
Удерживает каждый пункт длинной инструкции
На image-to-image дополнительный запас уходит на выполнение составных инструкций: возьми этот предмет, поставь на ту поверхность, подгони свет со второй картинки, конденсат не трогай. Обычное семейство теряет один из пунктов такой инструкции чаще, чем это.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Опишите и саму правку, и список того, что менять нельзя. Не менее 1 символов · Не более 5000 символов |
image_urls | Да | От одного до девяти референсов за вызов. Порядок значим: prompt обращается к ним по позиции, а последний задаёт пропорции, если |
bounding_boxes | Нет | Необязательные прямоугольники, отмечающие, где должна пройти правка, — не больше двух на референсное изображение. Не более 18 элементов |
aspect_ratio | Нет | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 или 2:3. Значения по умолчанию нет. |
color_palette | Нет | Необязательная цветовая тема из 3–10 цветов (рекомендуется 8). Не менее 3 элементов · Не более 10 элементов |
seed | Нет | От 0 до 2147483647. Зафиксируйте его на всём наборе вариантов, чтобы единственной разницей между двумя правками был изменённый вами оборот. |
Стоимость
$0.075 / изображение
Сценарии использования
Адаптировать утверждённое изображение к новой кампании
Отправьте пэкшот и целевую поверхность как два подписанных референса и попросите подогнать направление света и цветовую температуру под второй. Конденсат, этикетка и форма стекла останутся нетронутыми, потому что вы явно это указали.
Попробовать контролируемое изменение арт-дирекции
Сохраните позу и одежду с референса и в той же инструкции поменяйте свет или обстановку. Именно под составные инструкции настроен этот эндпоинт, так что назовите направление света, цветовую температуру и части, которые не должны сдвинуться.
Подготовить согласованную серию вариантов
Зафиксируйте seed для всей серии вариантов, чтобы две правки отличались только изменённой частью. Каждая правка выполняется на холсте 2k, около 4 мегапикселей; 4k доступен только в режиме «текст в изображение».
Руководство по промптам и практические советы
Скажите, что должно остаться и что может измениться
Называйте исходники по позиции — изображение 1, изображение 2 — и пишите изменение, а за ним список того, что меняться не должно. Если референсов от одного до девяти, назовите задачу каждого; последний задаёт пропорции, когда aspect_ratio не указан.
Делайте правку проверяемой по частям
Каждый запрос возвращает одно изображение. Собирайте серию вариантов, повторяя вызов с тем же seed и прочими входными данными, меняйте по одной части и сравнивайте каждый результат с исходником, а не с предыдущей правкой.
Проверьте результат, зависящий от исходника
Каждый референс должен быть в формате JPEG, PNG без прозрачности, BMP или WEBP, от 240 до 8000 пикселей по стороне, с соотношением сторон от 1:8 до 8:1 и не больше 20 МБ. Другое значение aspect_ratio перекомпонует кадр, а не обрезает его, поэтому проверьте, что сохранённые элементы остались на своих местах.
Быстрый старт 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/wan-2.7-pro/edit",
"input": {
"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.
