Рецепты промптов Seedream 5.0 Lite для редактирования изображений: 3 готовых к копированию кейса с реальными результатами «до и после»

Генерация изображения с нуля — уже решённая задача. Сложнее — и именно это встречается в реальных производственных процессах — редактирование: изменить только одно место, всё остальное сохранить. seedream-5.0-lite/image-to-image создан именно для этого: редактирование по инструкции с поддержкой до 14 референсных изображений, при котором неотредактированные области остаются неизменными.

В этой статье — три готовых к копированию рецепта редактирования для трёх действительно важных задач: одно точное локальное изменение, одна композиция из нескольких референсов и одна замена текста. Каждое изображение «после» ниже — результат первой генерации с показанным промптом: каждое редактирование выполнялось один раз, без повторов и без отбора. Изображения «до» сгенерированы текстовым вариантом той же модели, так что вы можете воспроизвести всю статью от начала до конца примерно за четверть цены.

Если вас интересуют возможности t2i этой модели — постеры, меню, рендеринг текста — мы уже рассказывали о них в шести рецептах промптов для t2i. Здесь только редактирование.

Настройка за 30 секунд

Эндпоинт редактирования работает через асинхронный API задач hiapi: создайте задачу с URL ваших референсов, опрашивайте её, скачайте результат.

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "YOUR EDIT INSTRUCTION",
      "image_urls": ["https://your-host.com/input.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'
# → {"data": {"taskId": "..."}}

curl https://api.hiapi.ai/v1/tasks/TASK_ID \
  -H "Authorization: Bearer $HIAPI_API_KEY"
# poll until "status": "success", then download output[0].url

Четыре вещи, которые стоит знать перед первым редактированием:

• image_urls, aspect_ratio и resolution — обязательные поля. Если не хватает любого из них, API вернёт 400 с перечислением отсутствующих полей (image_urls: missing required field "image_urls"; …). URL должны быть публично доступны.
• resolution принимает только "2K" или "4K". При передаче "1K" вернётся 400: resolution: value must be one of '2K', '4K' — то же правило, что и для эндпоинта t2i. Все изображения в этой статье — 2K.
• Согласовывайте aspect_ratio с входным изображением. Все наши референсы имеют формат 3:2, поэтому каждое редактирование запрашивает вывод 3:2. Борьба с геометрией входного изображения лишь потратит ваше редактирование на повторную обрезку.
• URL результатов истекают. Скачивайте файл сразу после успешного завершения задачи; не используйте горячие ссылки.

Цена фиксированная — $0.035 за изображение — независимо от количества референсов; см. тарифы. Заложите одну-две минуты на опрос для каждого редактирования в 2K и не рассчитывайте на синхронный ответ.

Рецепт 1: точное локальное изменение

Задача: изменить материал и цвет одного объекта, не трогая остальную сцену. Это самое частое редактирование для вариантов продукта — и именно здесь большинство моделей редактирования незаметно перерисовывают всю сцену.

Входное изображение, сгенерированное через t2i:

Инструкция для редактирования:

Change the matte white ceramic mug into a deep cobalt blue glazed mug
with a glossy reflective finish, keep the steam, the oak desk, the open
notebook, the fountain pen, the succulent, the lighting and the camera
angle exactly unchanged, photorealistic

Первая генерация:

Кружка превратилась из матово-белой в глянцево-кобальтовую — включая новые зеркальные блики, — а блокнот, кончик ручки, суккулент и оконный свет остались на местах. Обратите внимание на трёхчастную структуру промпта: назовите цель («the matte white ceramic mug»), опишите изменение («deep cobalt blue glazed, glossy»), а затем перечислите всё, что нельзя двигать. Этот список сохранения — не украшение; именно он фиксирует остальную часть кадра. Детали, которые модель перерисовывает (например, струйки пара), будут отличаться на уровне пикселей, даже если композиция осталась прежней, — поэтому планируйте допуски соответственно.

Рецепт 2: композиция из нескольких референсов

Задача: взять объект с одного изображения и поместить его в сцену с другого. seedream-5.0-lite принимает до 14 референсов за один вызов; здесь мы используем два.

Референс 1 — объект, студийное фото продукта:

Референс 2 — сцена:

Инструкция для редактирования — обратите внимание на порядковые числительные: так вы ссылаетесь на каждый референс:

Take the leather backpack from the first image and place it on the flat
granite boulder in the campsite scene from the second image, leaning
naturally at a slight angle, relit to match the warm golden-hour sunlight
with a soft shadow falling across the rock, keep the stone fire ring,
pine forest and mountain peaks unchanged, photorealistic composite

Первая генерация:

Рюкзак сохранил пряжки, швы и детали ремней со студийного фото, но освещение изменилось со студийного рассеянного на тёплый направленный солнечный свет, отбрасывающий контактную тень на гранит. Кострище, линия деревьев и горные вершины остались нетронутыми. В любой композиции из нескольких референсов ожидайте две вещи: модель немного скорректирует позу объекта, чтобы естественно вписать его в сцену (наш рюкзак наклонён чуть сильнее, чем на студийном фото), и полностью пересчитает освещение, а не вставит пиксели. Если вам нужна попиксельная идентичность объекта, это не тот инструмент — вы получите композицию без видимых следов вставки.

Рецепт 3: замена текста

Задача: заменить текст на вывеске, не перестраивая всю витрину. Сильная сторона Seedream — рендеринг текста, и эта возможность распространяется на эндпоинт редактирования.

Входное изображение:

Инструкция для редактирования:

Replace the text on the wooden sign above the door so it reads
'BAKERY CORNER' in the same gold serif lettering style and size, keep
the sign shape and wood texture, the brick facade, the glowing window,
the olive trees and the overcast lighting exactly unchanged,
photorealistic

Первая генерация:

«BAKERY CORNER» с первой попытки получилось с правильным написанием, правильным межбуквенным расстоянием и тем же шрифтом с засечками золотого цвета, что и в оригинале. Кирпичная кладка, оливковые деревья и тёплый свет из окна остались неизменными. Укажите точную строку ('BAKERY CORNER'), привяжите её к определённому месту («on the wooden sign above the door») и потребуйте исходный стиль («same gold serif lettering style and size») — та же дисциплина цитирования, которая дала 16/16 правильных строк в наших тестах t2i, работает и при редактировании.

Схема промпта для редактирования

Все три рецепта — одно и то же предложение, только с разными существительными:

1. Цель — назовите объект, который редактируете, с идентифицирующим признаком: «the matte white ceramic mug», «the text on the wooden sign above the door».
2. Изменение — конкретно опишите новое состояние: материал, цвет, поверхностный эффект, точный текст, положение в сцене.
3. Список сохранения — перечислите всё, что должно остаться: объекты, освещение, угол камеры. Завершите фразой «exactly unchanged». Список сохранения — самая эффективная часть промпта; каждый названный в нём предмет — это то, что модель не будет импровизировать.
4. Для нескольких референсов используйте порядковые числительные — при нескольких image_urls ссылайтесь на них как «the first image», «the second image». Порядок в массиве — это порядок в промпте.
5. Согласовывайте геометрию — запрашивайте то же соотношение сторон, что у входного изображения, и помните, что resolution принимает только 2K или 4K.

И честное предупреждение: редактирование — это повторный рендеринг, а не маска Photoshop. Области, которых касается модель (пар, отражения, края листвы), будут немного отличаться между изображениями «до» и «после». Эти рецепты дают вам стабильность композиции, идентичности и стиля — а не побитовое равенство неотредактированных областей.

Воспроизведение этих редактирований на Python

import os, time, requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}

task = requests.post(API, headers=HEADERS, json={
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
        "prompt": "Change the matte white ceramic mug into a deep cobalt "
                  "blue glazed mug with a glossy reflective finish, keep "
                  "the steam, the oak desk, the open notebook, the fountain "
                  "pen, the succulent, the lighting and the camera angle "
                  "exactly unchanged, photorealistic",
        "image_urls": ["https://your-host.com/desk-mug.jpg"],
        "aspect_ratio": "3:2",
        "resolution": "2K",
    },
}).json()
task_id = task["data"]["taskId"]

while True:
    t = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
    if t["status"] in ("success", "fail"):
        break
    time.sleep(5)

if t["status"] == "success":
    url = t["output"][0]["url"]  # expires — download immediately
    open("edited.jpg", "wb").write(requests.get(url).content)

Для рецептов 2 и 3 достаточно заменить prompt и image_urls. Более подробно о жизненном цикле задачи — обработке ошибок, тайм-аутах, вебхуках — см. руководство по API редактирования изображений.

Частые вопросы

Сколько референсов можно отправить? До 14 в одном массиве image_urls, все оплачиваются как одно редактирование за $0.035. На практике две-три тщательно подобранные референса лучше десяти размытых — каждое дополнительное изображение размывает внимание, приходящееся на каждое из них.

Сохраняется ли лицо/продукт между несколькими редактированиями? Для объектов идентичность сохраняется хорошо (наш рюкзак сохранил фурнитуру и швы после полного пересчёта освещения). Для критичных на уровне пикселей продуктовых задач — точных узоров этикеток, нормативных надписей — проверяйте каждый результат; модель выполняет повторный рендеринг, а не маскирование. Пример из продакшена см. в нашей статье о том, как мы создаём изображения товаров для электронной коммерции с помощью этого эндпоинта.

Почему мой вызов возвращает 400? Три частые причины: отсутствует обязательное поле (image_urls, aspect_ratio и resolution обязательны), resolution задан значением, отличным от 2K/4K, или URL референса недоступен публично.

2K или 4K? Для итераций — 2K: все изображения в этой статье в 2K, и текст в рецепте 3 остаётся чётким. 4K оставьте для финальных печатных/мастер-активов; цена за изображение та же, но генерация дольше.

---

Три редактирования, три первых генерации, по $0.035 за каждое. Эта схема — цель, изменение, список сохранения — нарочно скучная: скучные промпты — это воспроизводимые промпты. Получите API-ключ, откройте страницу модели seedream-5.0-lite/image-to-image, укажите на своё входное изображение «до» и начните с рецепта 1 — замена одного объекта быстрее всего покажет, сколько именно фиксирует список сохранения.