API Seedream 5.5
Создавайте, редактируйте изображения и разделяйте слои с Seedream 5.5. Параметры запросов, асинхронные задачи, метаданные изображений и актуальные цены.
Seedream 5.5 создаёт одно изображение по тексту или с использованием до 10 референсных изображений. Разделение на слои принимает одно изображение и возвращает основу и прозрачные слои с необязательным результатом распознавания печатного текста.
Попробовать Playground · OpenAPI JSON · Руководство по интеграции
Аутентификация и конечные точки
Используйте ключ Wan API как токен Bearer. Один ключ открывает доступ ко всем доступным моделям и группам; выбирать группу для ключа не требуется.
| Метод | URL | Назначение |
|---|---|---|
| POST | https://api.wanapi.app/seedream55/v1/images/generations | Отправить одну задачу изображения |
| GET | https://api.wanapi.app/seedream55/v1/tasks/{id} | Прочитать эту задачу |
ID модели — seedream-5-5. Это асинхронные конечные точки. Отправьте запрос один раз, сохраните ID задачи и опрашивайте её до completed или failed. Неопределённый сетевой ответ не даёт оснований повторять отправку.
Создание изображения
curl https://api.wanapi.app/seedream55/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedream-5-5",
"prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning light. No text.",
"size": "1K"
}'Принятый запрос возвращает задачу, а не байты изображения:
{"id":"task_example","model":"seedream-5-5","status":"processing","created_at":1794432000}curl https://api.wanapi.app/seedream55/v1/tasks/task_example \
-H "Authorization: Bearer $WAN_API_KEY"Опрашивайте тот же ID каждые несколько секунд. Сохраните его, если приложение прекращает ожидание, чтобы возобновить опрос позднее. ID задач и временные метки в этом руководстве приведены для примера.
Параметры
| Параметр | Тип | По умолчанию | Правила |
|---|---|---|---|
model | строка | обязателен | seedream-5-5 |
prompt | строка | обязателен для генерации | Необязателен для разделения на слои. |
image | URL или массив URL | нет | До 10 референсов; ровно один для слоёв. Каждый референс оплачивается. |
size | строка | 2K или auto для слоёв | См. правила размеров ниже. |
output_format | строка | png | png или jpeg. Для слоёв определяет только основное изображение. |
background | строка | auto | auto, opaque, transparent. Для прозрачности требуется PNG. Полностью исключите поле в режиме слоёв. |
layer_decomposition | логический | false | Разделить один референс на основное изображение и прозрачные слои PNG. |
layer_decomposition_options.max_images | целое число | 30 | Общий лимит 2–100 изображений, включая основное. Только для режима слоёв. |
layer_decomposition_options.text_recognition | логический | false | Запросить метаданные печатного текста в слоях. Только для режима слоёв. |
optimize_prompt_options.mode | строка | standard | Поддерживается только режим standard. |
watermark | логический | false | Запросить водяной знак о генерации ИИ. |
content_filter | логический | true | Клиентский API принимает false. В Playground отключать проверку могут только администраторы. |
Параметры n, seed, stream, resolution, aspect_ratio, image_urls и response_format не поддерживаются. Недокументированные поля отбрасываются и не включают эти возможности. Загрузка multipart, Base64 и data URI отклоняются.
Размер результата
Генерация принимает 1K, 1.5K, 2K или точные размеры WIDTHxHEIGHT в пикселях. Общая площадь должна составлять 921 600–4 624 220 пикселей, а соотношение сторон — от 1:16 до 16:1. Например, 2048x1152 допустимо. Соотношение вроде 16:9 не является значением размера.
Разделение на слои принимает auto, 1K, 1.5K или 2K; точные размеры в пикселях в этом режиме не поддерживаются. auto следует исходному размеру и резервирует стоимость по большему тарифу результата. Готовых размеров 3K и 4K у модели нет.
Референсные изображения и редактирование
Передавайте общедоступные HTTP(S) URL размещённых вами файлов без встроенных учётных данных. Поддерживаются JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC и HEIF, до 30 МБ на изображение и не более 36 000 000 пикселей всего. AVIF и JP2 не поддерживаются. URL должен отдавать изображение напрямую, без входа в аккаунт или браузерной проверки.
{
"model": "seedream-5-5",
"prompt": "Change the scene to a snowy winter night. Keep the lighthouse and its composition.",
"image": "https://your-cdn.example/lighthouse.jpg",
"size": "2K"
}Для нескольких референсов передайте массив URL и объясните роль каждого изображения в промпте. Результатом по-прежнему будет одно изображение. URL референсов в примерах — заполнители: замените их своими доступными файлами.
Разделение на слои и распознавание текста
{
"model": "seedream-5-5",
"image": "https://your-cdn.example/poster.png",
"size": "1K",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 4,
"text_recognition": true
}
}Лимит включает основное изображение; 4 означает не более четырёх полученных изображений, а не четыре слоя плюс основа. Модель может вернуть меньше. Не передавайте prompt для автоматического разделения или назовите элементы для отделения. Промпт может подавить исключённый им текст.
Слои — это файлы PNG с прозрачностью. Восстанавливайте изображение по возрастанию z_index, с основой на 0. Если задан ограничивающий прямоугольник, перед размещением измените размер слоя под него: пиксельные размеры файла слоя могут отличаться от размеров его размещения.
Необязательное поле text_recognition содержит полный text и lines. Каждая строка может включать bounding_box и оформленные фрагменты runs. Поле style фрагмента может включать similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow и translucent. Это оценки модели. Для художественных или рукописных надписей текстовый результат может отсутствовать; считайте поле необязательным.
Ответ завершённой задачи
{
"id": "task_example",
"model": "seedream-5-5",
"status": "completed",
"created_at": 1794432000,
"output": {
"data": [
{
"url": "https://api.wanapi.app/v1/tasks/task_example/artifacts/image-1/content?access=EXAMPLE",
"size": "1248x832",
"output_format": "png"
}
]
}
}У каждого изображения есть url и size. Другие поля могут включать output_format, background, z_index, name, description, bounding_box и text_recognition. bounding_box.absolute — это [left, top, right, bottom] в пикселях основного изображения. bounding_box.normalized использует те же координаты в масштабе 0–1000. Не считайте, что необязательные метаданные есть у каждого изображения.
Считайте URL изображений приватными ссылками для скачивания и сохраняйте нужные файлы. URL с токеном access можно открыть, не раскрывая ключ API аккаунта.
Цены
| Оплачиваемое изображение | USD за изображение |
|---|---|
| Результат до 2,61 Мп (1K / 1.5K) | 0,017 $ |
| Результат свыше 2,61 Мп (2K) | 0,02975 $ |
| Каждое референсное изображение, включая первое | 0,0068 $ |
Тарифы обновляются автоматически. Один ключ API работает со всеми моделями и группами.
Граница тарификации результата — 2 610 000 пикселей. Рассчитывайте стоимость так:
lower-band output count × lower-band rate
+ higher-band output count × higher-band rate
+ reference image count × reference rateКаждый референс оплачивается, включая первый и исходное изображение для слоёв. Генерация и слои используют одинаковые тарифы результата. При отправке резервируется стоимость одного результата или лимита слоёв max_images плюс референсов. При завершении используются собственные пиксельные размеры каждого полученного изображения, а неиспользованный резерв освобождается. Принятая задача сохраняет снимок цен, даже если тарифы изменятся во время выполнения. Для неудачных задач средства возвращаются.
Ошибки и повторные попытки
Некорректные параметры отклоняются до отправки. Недостаточный баланс или квота ключа препятствуют генерации. Аутентификация и проверка владельца применяются и к отправке, и к опросу. Неудачная задача возвращает status: "failed" с объектом error.
Повторяйте неудачное чтение статуса с тем же ID задачи. Не повторяйте POST генерации автоматически, в том числе после тайм-аута: запрос уже мог быть принят. Пока вышестоящий сервис сообщает о нормальном ходе выполнения, задача остаётся в ожидании. Если три часа подряд нет нормального статуса вышестоящего сервиса или успешной доставки, задача завершается ошибкой с возвратом средств.
В руководстве по Seedream 5.5 приведён цикл приложения, который сохраняет ID задачи и возобновляет работу с ним.