HiAPI
Блог

Руководство по использованию

Промпты для image-to-image в Seedream 5.0 Pro: 6 готовых рецептов с реальными результатами

Шесть рецептов редактирования для seedream-5.0-pro/image-to-image — композиция из нескольких референсов, перенос одежды, точечная смена цвета, замена фона, перенос стиля и цепочка кинематографической цветокоррекции — каждый с точным промптом и реальным результатом, который он выдаёт.

Jul 10, 2026
Промпты для image-to-image в Seedream 5.0 Pro: 6 готовых рецептов с реальными результатами

Text-to-image забирает внимание на демо, но настоящая работа — поместить продукт в сцену, переодеть модель, исправить один упрямый цвет, не трогая остальное — делается через image-to-image.seedream-5.0-pro/image-to-image — это Pro-уровень серии Seedream 5.0 от ByteDance, и его фирменная возможность — редактирование с несколькими референсами: вы передаёте до 10 изображений плюс промпт, задающий роль каждого из них.

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

Структура запроса (и её строгая схема)

seedream-5.0-pro/image-to-image работает на эндпоинте асинхронных задач. Ровно четыре входных поля, все обязательные:

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro/image-to-image",
    "input": {
      "prompt": "Recolor the ceramic pour-over mug to a matte black glaze with a thin brushed-gold rim along the lip. Preserve the identical mug shape, camera angle, soft studio lighting, contact shadow and warm off-white backdrop. Everything else in the frame stays untouched.",
      "image_urls": ["https://your-cdn.example.com/mug.jpg"],
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

Ответ возвращает taskId; опрашивайте GET /v1/tasks/{taskId}, пока status не станет success, после чего сразу скачивайте output[0].url — у выходного URL есть expireAt, и он истекает.

Схема строгая, и валидатор прямо скажет, что не так. Вот ошибки, которые мы получали во время тестов:

  • Пропущено любое поле → missing required field "prompt"; ... "image_urls"; ... "aspect_ratio"; ... "resolution"
  • Запрос 4K → resolution: value must be one of '1K', '2K'
  • Тихо добавлено лишнее поле вроде n → additional properties 'n' not allowed
  • Передано 11 референсов → image_urls: maxItems: got 11, want 10

Итак: вывод 1K или 2K, не более 10 референсов, никаких лишних полей. image_urls должны быть публично доступны для скачивания — платформа загружает их на своей стороне. Цена на странице тарифов — $0.15 за изображение, поэтому в нашем процессе ниже мы дешево генерируем референсы через gpt-image-2/text-to-image по $0.03, оставляя бюджет Pro на само редактирование.

Четыре референса

Все четыре сгенерированы через gpt-image-2 (промпты опущены ради краткости — это обычные описания продукта/портрета). Это входные данные, на которые ссылается каждый рецепт ниже.

Рецепт 1 — композиция из нескольких референсов: помещаем продукт в сцену

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

Place the terracotta pour-over coffee mug from the first image onto the empty oak
counter in the foreground of the second image. The mug sits naturally on the wood
surface, matching the warm golden sunrise lighting, with a soft window-light shadow
falling to the right. Keep the mug's shape, colour and matte ceramic material exactly
as in the reference. Keep the kitchen scene otherwise unchanged. Photorealistic
product photography.

aspect_ratio: "3:2" (под сцену, а не под продукт), resolution: "2K". Первая генерация:

Он не просто вставил кружку — он заново её осветил. Направление тени следует за окном, край кружки ловит рассветный свет, керамика остаётся матовой, а не перенимает тёплое освещение сцены.

Рецепт 2 — перенос одежды по нескольким референсам

Портрет впереди, одежда позади. Здесь главную роль играет список сохранения: лицо, волосы, серёжки, поза и фон полностью зафиксированы.

Dress the woman from the first image in the embroidered indigo denim jacket from the
second image, worn open over her grey sweatshirt. Keep her face, short black hair,
silver hoop earrings, expression, pose and the concrete wall background completely
unchanged. Match the overcast soft daylight and preserve the jacket's white floral
stitching details on the chest and sleeves.

aspect_ratio: "3:4", resolution: "2K":

Вышивка полностью сохранилась от раскладки до носки — рукава, расположение на груди и даже фурнитура пуговиц. Именно здесь Pro-уровень оправдывает свою цену: одна генерация сохраняет и личность, и детали одежды.

Рецепт 3 — точечная смена цвета: режим списка сохранения

Один референс. Изменение — одно предложение; дальше всё — список сохранения. Это универсальный шаблон для задач типа «измени X, не трогай ничего другого».

Recolor the ceramic pour-over mug to a matte black glaze with a thin brushed-gold rim
along the lip. Preserve the identical mug shape, camera angle, soft studio lighting,
contact shadow and warm off-white backdrop. Everything else in the frame stays
untouched.

aspect_ratio: "1:1", resolution: "2K":

Тот же контур, та же тень, тот же фон — изменилась только глазурь. Он даже добавил золотое кольцо у основания, перекликающееся с краем, — мы этого не просили, но оставили.

Рецепт 4 — замена фона с пунктом о переосвещении

Заменить фон, не переосветив субъект, — и получится композит, похожий на картонный вырез. Решение — явно потребовать переосвещения, заодно зафиксировав личность:

Swap the plain concrete wall behind the woman for a rain-soaked city street at night
glowing with neon signs, cyan and magenta reflections and soft distant bokeh. The
woman herself — face, short black hair, silver hoop earrings, expression, pose, grey
sweatshirt — stays exactly as she is, identity preserved. Add a subtle cool neon rim
light so she blends naturally into the night scene.

aspect_ratio: "3:4", resolution: "2K":

Обратите внимание на пурпурный отсвет справа от неё и голубую кромку на худи — это работает пункт о переосвещении. То же лицо, те же серьги, совершенно другой мир.

Рецепт 5 — перенос стиля: фото в акварель

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

Repaint this photograph as a loose watercolor illustration: visible paper grain, soft
pigment bleeds, delicate hand-drawn ink outlines. Keep the composition, the window,
the vase and the morning-light mood. Pastel palette dominated by warm yellows and
soft blues.

aspect_ratio: "3:2", resolution: "2K". Первая генерация:

Рецепт 6 — цепочка правок: кинематографическая цветокоррекция поверх рецепта 3

Вывод становится входом. Мы взяли чёрно-золотую кружку из рецепта 3 — уже загруженную на наш собственный CDN — напрямую как референс для следующего прохода обработки настроения:

Turn this product photo into a moody cinematic hero shot: dramatic low-key lighting,
background falling off into deep shadow, a gentle wisp of steam rising from the mug,
subtle film grain, teal-and-orange colour grade. Keep the mug's black-and-gold design,
shape and camera angle exactly identical.

aspect_ratio: "1:1", resolution: "2K". Первая генерация:

Одно изменение за шаг лучше одного огромного промпта: результат смены цвета фиксируется с первого шага, а на этапе цветокоррекции остаётся думать только об освещении. Цепочка стоит дополнительно $0.15, но каждый шаг можно независимо перезапустить — и переиспользовать.

Три шаблона промптов, которые реально работают

  1. Называйте роли референсов. «Кружка с первого изображения», «столешница со второго изображения» — порядок в image_urls и есть порядок, на который ссылается промпт. Неоднозначность здесь — причина номер один, почему модель меняет не то.
  2. Цель → изменение → список сохранения. Сначала скажите, что редактируете, затем назовите это одно изменение, затем перечислите всё, что нельзя трогать. Именно список сохранения фиксирует личность, освещение и композицию — пропустите его, и модель начнёт «улучшать» то, о чём вы не просили.
  3. Добавляйте пункт о переосвещении, когда субъект переносится в другой мир. «Слегка переосвети её холодным неоновым контурным светом» — вот разница между композитом и фотографией.

Подводные камни, на которые мы реально наступили

  • TASK_FAILED без деталей обычно временный. Три из шести наших рецептов так упали при первой отправке — тот же payload прошёл при повторе (один — точная повторная отправка, два — слегка переформулированные). Сначала отправьте заново, потом думайте о переписывании.
  • Схема — это всерьёз. Никаких n, seed, size — ровно четыре поля, лишние дают 400. Если вы переносите код с более свободной модели, не забудьте вычистить payload.
  • Поддерживается только 1K/2K. Если вам нужен вывод 4K в этой серии, это функция уровня text-to-image, а не этого эндпоинта.
  • URL референсов должны быть публичными. Платформа загружает их на своей стороне; предподписанные URL, истекающие посреди опроса, вас подведут.
  • Скачивайте вывод сразу. output[0].url истекает. Прежде чем делать что-либо ещё, заберите байты в собственное хранилище.

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

Когда Pro стоит своих 4-кратных денег относительно Lite? seedream-5.0-lite/image-to-image стоит $0.035 и хорошо справляется с локальными правками одного субъекта. В наших тестах Pro заметно впереди на задачах с несколькими референсами — сохранение деталей одежды при переносе и сохранение личности при полной замене фона. Если правка включает два или более референсов или лицо, которое ни в коем случае не должно «поплыть», берите Pro.

Как он сравняется с другими моделями редактирования? Мы прогнали одно и то же редактирование через три модели в сравнении API для image-to-image — это отдельная статья с реальными сравнениями бок о бок.

Можно ли генерировать референсы тем же API? Да — каждое референсное изображение в этой статье получено через gpt-image-2/text-to-image по $0.03 за штуку на том же эндпоинте /v1/tasks. Один ключ покрывает оба этапа рабочего процесса.


Общая стоимость всех правок в этой статье: шесть правок Pro по $0.15 плюс четыре референса по $0.03 — чуть больше доллара. Возьмите один ключ, сверьте четырёхполевую схему в документации и начните с режима списка сохранения из рецепта 3 — это то, что вы будете использовать каждый день. Полный справочник параметров — на странице модели seedream-5.0-pro/image-to-image.

Похожие статьи

Все статьи →

Начните работать с постоянными артефактами ИИ

Получите API-ключ и вызывайте модели изображений, видео и аудио через один API на основе tasks.

Читать документацию API