До окончания—Модели Wan: скидка до 45% от официальной цены
LogoWan API
  • Модели
  • Разработчикам
  • Цены
  • Документация API
  • Руководства
Руководство по API Seedream 5.5: генерация, редактирование и разделение изображений
12.11.2026

Руководство по API Seedream 5.5: генерация, редактирование и разделение изображений

Вызовите Seedream 5.5 один раз, опрашивайте задачу, редактируйте по референсам, создавайте прозрачные PNG и разделяйте на слои. Размеры и цены изображений.

Seedream 5.5 возвращает ID задачи раньше изображения. Отправьте запрос один раз, сохраните ID и опрашивайте задачу до готовности результата. Генерация создаёт одно изображение; разделение на слои может создать основу и прозрачные слои. Оба процесса используют model: "seedream-5-5", но правила входных данных различаются. 1

В этом руководстве задание на керамический чайник проходит генерацию и целевое редактирование, затем показано разделение существующего постера на слои. Playground Seedream 5.5 предоставляет те же настройки запроса. Там можно проверить JSON перед добавлением в приложение.

Контракт проверен 12 ноября 2026 года. Интеграционные проверки воспроизвели 34 случая запросов и ответов, включая несовместимые настройки прозрачности, ограничения слоёв и завершённые результаты без пригодных размеров. Эти проверки подтверждают обработку запросов и входные данные для учёта стоимости; это не тест скорости генерации или качества изображений. Ниже показаны существующие примеры Seedream 5.5 от 10 ноября.

Начните с ключа и одного небольшого запроса

Создайте ключ в разделе Ключи API, храните его на сервере и используйте https://api.wanapi.app как базовый URL. Ваш существующий ключ Wan API работает со всеми доступными моделями и группами. Отдельный ключ для этой модели изображений покупать или выбирать не нужно.

Сохраните это как generate.json:

{
  "model": "seedream-5-5",
  "prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
  "size": "1K",
  "output_format": "png",
  "content_filter": true
}

Задайте WAN_API_KEY в окружении сервера, затем отправьте запрос один раз:

curl --fail-with-body --retry 0 --max-time 90 \
  https://api.wanapi.app/seedream55/v1/images/generations \
  -H "Authorization: Bearer $WAN_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @generate.json \
  -o submitted.json

Успешный ответ содержит id, model и статус обработки. Сохраните файл submitted.json целиком. Не считайте отсутствие URL изображения ошибкой генерации: этот ответ подтверждает принятие задачи. Если соединение оборвалось до получения ID, проверьте журнал задач перед новым POST. Неопределённый ответ не даёт оснований создавать ту же платную задачу снова.

Для первого запроса мы явно выбрали 1K. Если не передавать size, генерация по умолчанию использует 2K. Формат по умолчанию — PNG, водяной знак выключен, проверка контента включена. Пользователи публичного API могут явно менять content_filter; Playground оставляет проверку включённой для обычных аккаунтов. 1

Опрашивайте сохранённый ID, в том числе после обновления страницы

URL опроса — GET /seedream55/v1/tasks/{id}. Ответ завершённой задачи хранит изображения в output.data; он не использует формат ответа синхронного Images API. У каждой записи есть URL и фактический размер в пикселях.

Этот скрипт Python читает сохранённый ответ и опрашивает задачу до десяти минут. Он отправляет только GET, поэтому повторный запуск продолжает существующую задачу:

import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path

saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600

while time.monotonic() < deadline:
    request = urllib.request.Request(
        url,
        headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
    )
    try:
        with urllib.request.urlopen(request, timeout=30) as response:
            task = json.load(response)
    except urllib.error.HTTPError as error:
        if error.code != 429 and error.code < 500:
            raise
        time.sleep(5)
        continue
    except (urllib.error.URLError, TimeoutError):
        time.sleep(5)
        continue

    if task["id"] != task_id:
        raise RuntimeError("Unexpected task identity")
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
    if task["status"] == "completed":
        Path("result.json").write_text(json.dumps(task, indent=2))
        for index, image in enumerate(task["output"]["data"], start=1):
            print(index, image["size"], image["url"])
        break
    time.sleep(5)
else:
    print("Still waiting. Keep submitted.json and resume this GET later.")

Десятиминутный лимит относится к клиенту из этого примера. Он не отменяет задачу и не доказывает ошибку генерации. Для этой интеграции мы не установили измеренный диапазон задержек, поэтому предусмотрите состояние ожидания вместо обещания фиксированного числа секунд. Сохраните скачанные файлы после готовности; не считайте URL результатов постоянным хранилищем материалов.

Керамический чайник в форме лисы на льняной скатерти, созданный в Seedream 5.5

Размер этого примера — 1248 × 832 пикселя. Готовый размер 1K — это уровень разрешения, а не обещание, что обе стороны равны 1024. Читайте size из результата, если для макета или расчёта стоимости нужны точные размеры.

Меняйте сцену, указывая, что нужно сохранить

Для редактирования добавьте image с общедоступным HTTP(S) URL. Это может быть размещённое вами исходное фото или сгенерированный файл, который вы скачали и самостоятельно разместили. Референсами не могут быть загружаемые файлы, Base64 или data URI. Они должны оставаться доступными во время обработки запроса. Поддерживаемые входные форматы и ограничения медиа перечислены в документации API. 1

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/fox-teapot.png",
  "prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
  "size": "1K"
}

URL выше — заполнитель; замените его своим доступным изображением. Отправьте запрос как отдельную, намеренно созданную задачу редактирования и сохраните ответ под новым именем файла. Модель не помнит предыдущую задачу: нужно передать изображение, которое вы хотите редактировать.

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

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

Для изображения без фона добавьте "background": "transparent" и оставьте "output_format": "png". JPEG не поддерживает такой альфа-канал. Прозрачность доступна для генерации и редактирования; для режима слоёв ниже приведены отдельные правила.

Разделите постер на слои для повторного использования

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

{
  "model": "seedream-5-5",
  "image": "https://your-public-host.example/poster.png",
  "size": "1K",
  "layer_decomposition": true,
  "layer_decomposition_options": {
    "max_images": 4,
    "text_recognition": true
  },
  "output_format": "png"
}

max_images учитывает и основное изображение. Поэтому четыре допускает основу и до трёх слоёв. Допустимый лимит — 2–100, по умолчанию 30; модель может вернуть меньше изображений. Не передавайте background в этом режиме, даже со значением auto. Отделённые слои уже являются прозрачными PNG; output_format определяет формат основы. 1

Исходный постер Seedream 5.5, отделённый фон, музыкант и прозрачные текстовые слои

Этот существующий пример объединяет исходный постер и полученные прозрачные элементы. Он помогает понять смысл разделения, но не гарантирует, что каждый постер даст такое же число слоёв или чистые границы.

Проверяйте необязательные метаданные каждого результата:

ПолеКак использовать
z_indexРазмещайте большие значения выше меньших.
bounding_box.absoluteРазмещайте слой по левой, верхней, правой и нижней координатам в пикселях основного изображения.
bounding_box.normalizedСоответствующие координаты в масштабе 0–1000.
name, descriptionОпределяйте элемент, отделённый моделью.
text_recognitionЧитайте распознанный текст, строки и доступные сведения о стиле.

Сохраняйте весь JSON результата, а не только URL. Размер изображения слоя может отличаться от размеров его размещения на основном холсте. При восстановлении композиции используйте ограничивающий прямоугольник и проверяйте результат визуально. Рекомендации шрифтов — это оценки; метаданные OCR не гарантируют исходный шрифт или готовый файл PSD. Художественные надписи, перекрывающиеся элементы и исключённый промптом текст могут давать неполные результаты.

Выберите размеры перед сравнением стоимости

Генерация поддерживает 1K, 1.5K и 2K, а также точные размеры WIDTHxHEIGHT в пределах 921 600–4 624 220 пикселей всего и с соотношением сторон от 1:16 до 16:1. Режим слоёв принимает эти готовые размеры или auto, но не точные размеры. Этот контракт не предоставляет готовых размеров 3K или 4K, пакетного n, seed и быстрой оптимизации промпта. Параметры другой версии Seedream не следует переносить без проверки. 1

Здесь показаны актуальные тарифы из того же источника цен, что и в Playground:

Цены сейчас недоступны. Обновите страницу, чтобы повторить попытку.

Тарифы обновляются автоматически. Один ключ API работает со всеми моделями и группами.

Пусть L — тариф результата до 2,61 миллиона пикселей, H — тариф выше этой границы, а R — тариф референсного изображения. Генерация 1K без референса стоит L; редактирование с одним референсом — L + R. Для 1K и 1.5K действует меньший тариф результата. Оплачивается каждый референс, включая первый. 2

Запрос слоёв 1K с лимитом четыре изображения оценивается как 4L + R. Если вернутся только основа и два слоя, каждый в нижнем диапазоне, итог составит 3L + R. При разных размерах считайте каждое изображение отдельно: два изображения нижнего диапазона и одно более крупное стоят 2L + H + R. Основа является выходным изображением и должна входить в этот подсчёт.

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

Когда запрос или результат требует внимания

Ошибка валидации обычно указывает на несовместимость режима: несколько референсов в режиме слоёв, прозрачный JPEG, неподдерживаемый размер или настройки слоёв в запросе генерации. Исправьте запрос перед созданием новой задачи. Временная ошибка опроса — другой случай: сохраните существующий ID и повторите GET. Это разные решения, и объединение их в общий обработчик «повторить всё» создаёт риск повторной платной генерации.

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

Seedream 5.5 подходит для процессов, которым нужны генерация, редактирование по референсам или отделяемые элементы дизайна в рамках этого контракта. Seedream 5.0 Pro — отдельная модель с другими настройками по умолчанию и ограничениями. Мы не проводили контролируемого сравнения, позволяющего утверждать, что одна из них всегда лучше. Это руководство также не заявляет об отдельной доступности «5.5 Pro» и не обещает бесплатную генерацию. Актуальные Playground и цены смотрите на странице модели, а документ OpenAPI используйте для добавления валидации запросов в приложение.

Источники

  1. Документация API Seedream 5.5: поля запросов, настройки по умолчанию, URL на входе, асинхронные ответы и метаданные слоёв. Контракт проверен 12 ноября 2026 года.
  1. Актуальные цены Seedream 5.5: диапазоны пикселей результата и тарифы референсных изображений.
Все статьи

Автор

avatar for Wan API
Wan API

Категории

  • Продукт
Начните с ключа и одного небольшого запросаОпрашивайте сохранённый ID, в том числе после обновления страницыМеняйте сцену, указывая, что нужно сохранитьРазделите постер на слои для повторного использованияВыберите размеры перед сравнением стоимостиКогда запрос или результат требует вниманияИсточники

Другие статьи

Seedance 2.5 или Seedance 2.0: что подойдёт вашей сцене?
Продукт

Seedance 2.5 или Seedance 2.0: что подойдёт вашей сцене?

Сравните длительность, лимиты референсов и настройки примеров Seedance 2.5 и 2.0. Подготовьте честный тест без предположений о качестве и скорости.

avatar for Wan API
Wan API
14.10.2026
Seedance 2.5 Flash: цены
Продукт

Seedance 2.5 Flash: цены

Рассчитайте стоимость пятисекундного ролика Seedance 2.5 Flash по актуальным тарифам 480p и 720p для текста, референсов и редактирования.

avatar for Wan API
Wan API
18.11.2026
Seedance 2.0 Fast и Mini: какую модель протестировать?
Продукт

Seedance 2.0 Fast и Mini: какую модель протестировать?

Сравните ограничения Fast и Mini, оплату референсного видео и примеры сцен. Одинаковое задание поможет оценить качество, время и стоимость удачного кадра.

avatar for Wan API
Wan API
15.10.2026

Новости Wan API

Новости сервиса и моделей

Подпишитесь на новости моделей, обновления сервиса и информацию об интеграции API.

LogoWan API

Wan 3.0 и Wan 3.0 Prime. Генерация видео для вашего следующего проекта.Независимая платформа. Не связана с Alibaba, Wan или ByteDance и не поддерживается ими.

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
Модели
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • Цены
Разработчикам
  • Документация
  • Руководство по Wan 3.0
  • Вопросы и ответы
  • О Wan API
  • Связаться с Wan API
Правовая информация
  • Конфиденциальность
  • Условия
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. Все права защищены.