Редактирование в Seedream 4.0: роли референсов, точные размеры и изображения по 0,03 $

Редактор Seedream 4.0 принимает от 1 до 10 референсных изображений и возвращает одно изображение в размере, который вы выбираете из шестнадцати пресетов. Стоимость — 0,03 $ за изображение при любом размере и любом числе референсов. Здесь нет маски, ползунка силы и seed, поэтому весь контроль даёт промпт: используйте модель для смены одежды, фона и освещения или чтобы превратить набросок в рендер, но не для правок, при которых все остальные пиксели должны остаться нетронутыми.

SpicyAPI не добавляет к этому редактору дополнительный фильтр контента на уровне платформы. В наших тестах в сентябре 2026 года правки для взрослых более высокой интенсивности иногда возвращались мягче, чем запрошено, при том что задача отображалась как успешная, поэтому проверяйте изображение, прежде чем использовать его.

Дайте каждому референсу задачу

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

Для смены одежды загрузите одобренное изображение вымышленного взрослого в простой куртке, выберите 1728*2304 и используйте:

Сохрани с изображения один лицо, причёску, позу, руки, ракурс камеры и фон вымышленного взрослого. Замени только куртку на непрозрачный бордовый бархатный блейзер поверх имеющейся кремовой рубашки. Сохрани исходную длину куртки и форму плеч. Покажи мягкий блеск бархата при существующем освещении, с чёткими лацканами, без новых украшений и текста.

Запрос «сделай наряд роскошнее» оставляет конструкцию открытой и может вернуть совсем другой костюм. Чтобы получить конкретный блейзер, добавьте его как изображение два и замените фразу о материале на: «Изображение два задаёт крой, лацканы и ткань бордового блейзера. Используй только эту вещь; человека, позу и сцену оставь с изображения один». Обрежьте фото вещи так, чтобы остался только предмет одежды: полноценный модный снимок приносит с собой ещё и лицо, тело и освещение.

SpicyAPI принимает до десяти референсов. Каждый файл может быть JPG, PNG, WEBP или GIF размером до 10 МБ, для изображений, на которые у вас есть права.

Выберите точный размер

Seedream 4.0 принимает size как строку width*height, а не поля resolution и aspect_ratio, как модели 5.0. По умолчанию используется 2048*2048. Результат перестраивается под выбранный пресет, а не вырезается из исходника, поэтому вертикальный исходник, отправленный с квадратом по умолчанию, будет скомпонован заново, и кадрирование может измениться. Подбирайте размер под форму исходника.

1024*1024 — последний оставшийся пресет. Другие размеры отклоняются. 4096*2304 — самый большой кадр среди редакторов Seedream в SpicyAPI; у 5.0 Lite максимум 3136*1344.

Пресета 4:5 нет. Для карточки 4:5 в соцсетях либо используйте 1728*2304 и оставьте запас под небольшую обрезку, либо перейдите на Seedream 5.0 Flash (0,029 $ за изображение) или 5.0 Pro, которые принимают aspect_ratio: 4:5. У Pro цена начинается с 0,036 $ за изображение и растёт при 2K и с дополнительными референсами.

Сначала попробуйте в Playground

Запустите правку в Playground, прежде чем писать код: результат, который неверен здесь, будет неверен и через API, а исправление — это улучшенный промпт или референс.

1. Откройте страницу редактирования Seedream 4.0 и оставайтесь на вкладке Playground в режиме Form. Чтобы запустить, войдите в аккаунт с положительным балансом.
2. Добавьте источники в разделе Images: перетащите файл или вставьте ссылку через Add URL. До 10; порядок добавления — это «изображение один», «изображение два».
3. Опишите изменение в поле Prompt, указав, что вносит каждое изображение и что должно сохраниться.
4. Выберите Output size в соответствии с формой исходника.
5. Проверьте оценку цены и запустите. Режим JSON показывает тело запроса, которое можно скопировать в код.

Затем вызовите из кода

Установите Python SDK (pip install spicyapi), задайте SPICY_API_KEY в окружении сервера и запустите:

import uuid
from spicyapi import SpicyClient, output_assets

client = SpicyClient()  # reads SPICY_API_KEY from the environment

task = client.create_task(
    model="bytedance/seedream-4.0/edit",
    input_data={
        "image_urls": [
            "https://example.com/person.png",
            "https://example.com/blazer.png",
        ],
        "prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
        "size": "1728*2304",
    },
    idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
    raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"])  # copy it to your own storage now

Замените два примера URL своими; они должны открываться без входа в аккаунт, либо загрузите локальный файл и передайте возвращённый URI spicy://. Ссылка на результат действует около 20 минут (подробнее о хранении). Расчёт стоимости, загрузки, ожидание, повторы и ошибки описаны в справочнике Python SDK и в руководстве по асинхронным задачам.

Или поручите агенту

Если ассистент должен выполнять правки за вас, дайте ему CLI, MCP-сервер или Skill. CLI и MCP-сервер показывают цену и спрашивают вас перед платным вызовом.

• CLI. Поместите тот же объект input в input.json и выполните следующую команду (npx @spicyapi/cli работает без установки; см. документацию CLI):

``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``

• MCP-сервер. Добавьте MCP-сервер своему ассистенту и попросите: «Отредактируй ./portrait.png в Seedream 4.0: замени только куртку на бордовый бархатный блейзер, размер 1728*2304». Он вызывает spicyapi_upload_file, затем spicyapi_task_create, который останавливается для подтверждения цены, а потом spicyapi_task_wait.
• Skill. npx skills add spicyapi-ai/spicy-skill устанавливает Agent Skill, благодаря которому ассистент для программирования читает актуальную схему модели, а не угадывает поля.

Превратите набросок в концепт материала

Поставьте набросок первым, а образец материала вторым и скажите, за что отвечает каждый. Пример с вымышленными часами:

Преврати набросок часов с изображения один в реалистичный продуктовый концепт. Сохрани сплошной арочный корпус, центрированный круглый кремовый циферблат и две короткие ножки. Используй изображение два только для цвета и текстуры ореха. Сделай ножки матовыми латунными, а на циферблат добавь две простые чёрные стрелки. Вид спереди на светлой каменной поверхности, мягкий боковой свет, без брендинга и лишних предметов.

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

Исправление конкретных сбоев

Новый наряд изменил лицо. Вернитесь к исходному портрету, уберите лишних людей с референса одежды и сохраните исходный ракурс. Если лицо должно остаться точным до пикселя, наложите одобренное лицо привычным способом вместо нового полного перерисовывания.

Материал распространился на другие предметы. Назовите поверхность: бархат относится только к блейзеру, рубашка остаётся из кремового хлопка; орех относится к корпусу часов, а не к циферблату и латунным ножкам. Узкий образец понятнее, чем целая комната в качестве «стилевого» изображения.

Силуэт наброска изменился. Упростите набросок и запросите вид спереди. Эффектный ракурс может скрыть контур, который вы хотели сохранить.

Объект обрезан. Выберите пресет, подходящий по форме, и попросите оставить пространство вокруг головы, ног или реквизита.

Маленький логотип или фраза неверны. Оставьте сцену и замените этот элемент в обычном редакторе. Без маски исправление текста — это новая перерисовка, а не локальная заплатка.

При повторных правках изображение дрейфует. Каждый проход перерисовывает кадр. Для накопительных изменений берите последний принятый результат и проверяйте, что сместилось; если возвращаетесь к оригиналу, включите в промпт все принятые изменения. Независимые варианты начинайте с общего оригинала.

Стоимость и когда выбрать другую модель

Три правки стоят 0,09 $, десять — 0,30 $. Увеличенные размеры и дополнительные референсы ничего не добавляют. Для нового изображения без исходника используйте Seedream 4.0 текст в изображение: те же размеры и та же цена.

Выбирайте 4.0 для больших кадров до 4096*2304 по фиксированной цене. Выбирайте модель 5.0, если нужен aspect_ratio, например 4:5, вывод в PNG (все модели 5.0) или прозрачный фон (Flash и Pro). Выбирайте другой метод, если нужны маска, сохранение пикселей или точная инженерная геометрия. О рекламных креативах из фото товара см. от фото товара к рекламному креативу.