Seedream-5.0-Pro
Генерация изображений Seedream-5.0-Pro
- Асинхронный режим обработки, возвращает идентификатор задачи для последующих запросов
- Поддерживает text-to-image, image-to-image с одним изображением и с несколькими референсными изображениями (до 10)
- Поддерживает уровни разрешения 1K / 1.5K / 2K или точные пиксели через
size - Модель одиночного изображения: 1 изображение за запрос; вывод PNG / JPEG
- Ссылки на сгенерированные изображения действительны в течение 72 часов, своевременно сохраняйте их
POST
Авторизация
string
обязательно
Все конечные точки API требуют аутентификации Bearer TokenПолучите свой API Key:Перейдите на страницу управления API ключами, чтобы получить свой API KeyДобавьте его в заголовок запроса:
Модель одиночных изображений:
seedream-5-0-pro создаёт только 1 изображение за запрос (кроме декомпозиции на слои). Следующие параметры отклоняются (HTTP 400, задача не создаётся, оплата не списывается):n > 1sequential_image_generation(групповая генерация не поддерживается)stream(потоковая передача не поддерживается)tools(веб-поиск не поддерживается)- более 10 элементов в
image_urls
Интерактивное редактирование
Используйте координаты
<point> / <bbox> в промпте или загрузите изображение с рукописными пометками, чтобы точно указать область редактирования.- Координаты точки:
<point>x y</point>(задают одну точку; модель определяет область воздействия) - Координаты ограничивающей рамки:
<bbox>x1 y1 x2 y2</bbox>(задают координаты левого верхнего и правого нижнего углов для точного управления размером области редактирования)
Декомпозиция на слои
Разделите одно изображение на базовое изображение и до 16 прозрачных PNG-слоёв с данными о позиции и порядке наложения.
Тело запроса
string
по умолчанию:"seedream-5-0-pro"
обязательно
Название модели генерации изображений
seedream-5-0-pro(рекомендуется)- Также принимается:
seedream-5.0-pro
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
true: проверить промпты и входные изображения с помощьюomni-moderation-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображенияНеобязателен при
layer_decomposition: true; если опущен, модель автоматически определит и разделит основные элементы изображения.Помимо китайского и английского, нативная генерация текста поддерживает русский, арабский, филиппинский, тайский, турецкий, корейский, малайский, испанский, португальский, индонезийский, французский, немецкий, вьетнамский и японский языки.Совет: не более 600 английских слов; слишком длинное описание может привести к потере деталей.
string
по умолчанию:"1K"
Уровень разрешения (допускается нижний регистр). Это расширение API Mart, эквивалентное прямому указанию уровня в
size.1K(по умолчанию)1.5K(та же цена, что у 1K, лучше качество — предпочтительно 1.5K, если нет причин иначе)2K
size в виде уровня и resolution, приоритет имеет size.string
по умолчанию:"auto"
Ключевое слово уровня, соотношение сторон, Эти форматы эквивалентны. Если задан только уровень, опишите желаемую компоновку в промпте (например, “вертикальный плакат” или “горизонтальная обложка”) и позвольте модели выбрать соотношение сторон.
auto или точные размеры в пикселях.Формат ①: уровень разрешения (рекомендуется)
Уровень можно указать непосредственно вsize или через поле расширения API Mart resolution:Формат ②: уровень + соотношение сторон
Используется сresolution. Поддерживаемые соотношения:1:1,4:3,3:4,16:9,9:16,3:2,2:3,2:1,1:2,21:9- Также принимается разделитель
xв стиле16x9 2x1эквивалентно2:1, а1x2—1:2. Символxдолжен быть строчным; пробелы не допускаются.auto(по умолчанию): применяется только уровень разрешения; итоговое соотношение выбирается по prompt / референсам
9:21) возвращают 400 — без тихого отката к 1:1.Уровень × соотношение → пиксели вывода:Формат ③: точные пиксели
Когдаsize — widthxheight, пиксели используются как есть, resolution не применяется. Принимаются 2048X1024 / 2048×1024.string
по умолчанию:"opaque"
Режим фона выходного изображения:
opaque: непрозрачный фон (по умолчанию)transparent: прозрачный фон
transparent доступен только для запросов image-to-image с ровно одним входным изображением, уже содержащим альфа-канал; также требуется output_format: "png".boolean
по умолчанию:"false"
Указывает, нужно ли разложить изображение на слои. При включении модель возвращает одно базовое изображение и до 16 PNG-слоёв с альфа-каналами.Требуется ровно одно изображение PNG или JPEG. Оно должно содержать от
[262144, 36000000] пикселей и иметь размер не более 30 МБ. size принимает только 1K, 1.5K, 2K или auto; по умолчанию — auto. output_format управляет только форматом базового изображения; слои всегда возвращаются в PNG.object
по умолчанию:"{\"mode\":\"standard\"}"
Режим оптимизации промпта:
standard: стандартный режим с лучшим качеством (по умолчанию)
"optimize_prompt_options.mode": "standard".integer
по умолчанию:"1"
Число создаваемых изображений. Поддерживается только
1; для групповой генерации используйте seedream-5-0-lite.array
Список URL референсных изображений для image-to-image с одним / несколькими референсами, до 10Два формата:1. Публичный URL
http://илиhttps://- Пример:
https://example.com/image.jpg
- Формат:
data:image/<format>;base64,<data>—<format>должен быть в нижнем регистре - Пример:
data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...
- Форматы: jpeg / png / webp / bmp / tiff / gif / heic / heif
- Соотношение сторон (w/h):
[1/16, 16] - Каждая сторона > 14 px
- Размер ≤ 30 MB
- Всего пикселей ≤
6000×6000(36,000,000)
Тарификация: первое референсное изображение бесплатно; каждое дополнительное — фиксированная доплата.
string
по умолчанию:"jpeg"
Формат выходного изображения
jpeg(по умолчанию)png
Совместимость:response_formatэквивалентенoutput_format; прочие значения обрабатываются какjpeg.
boolean
по умолчанию:"false"
Добавлять ли водяной знак “AI generated” в правом нижнем углу
true: добавить водяной знакfalse: без водяного знака (по умолчанию)
Примеры запросов
Text-to-image (уровень + соотношение)
Text-to-image (точные пиксели)
Несколько референсов
Рекомендуется: 1.5K та же цена, лучше качество
Декомпозиция на слои
<bbox>, нормализованные к 0–1000, чтобы точно указать извлекаемые элементы:
Интерактивное редактирование
Опишите рукописные пометки на изображении естественным языком:<point> / <bbox>:
Редактирование альфа-канала
Полный пример: отправка задачи и получение изображения
Скрипт ниже показывает полный цикл: отправку асинхронной задачи, опрос её статуса, обработку ошибок и чтение итогового URL изображения. Перед запуском заменитеYOUR_API_KEY.
Python
Возвращаемые изображения зеркалируются в хранилище под управлением платформы. Всё равно своевременно скачайте и сохраните их в своей системе; не считайте URL результата постоянным хранилищем.
Полные сценарии cURL
Композиция из нескольких изображений (до 10 референсов)
Точные пиксели, оптимизация промпта и водяной знак
Декомпозиция и отдельное редактирование прозрачного слоя
Сначала разложите исходное изображение:Ответ декомпозиции на слои и реконструкция
Массивыurl, sizes, output_formats и layers соответствуют друг другу по индексу; индекс 0 всегда обозначает базовое изображение:
z_index. Для реконструкции на базовом выходном изображении по абсолютным координатам:
W × H используйте нормализованные координаты:
Примечания по тарификации
- 1.5K стоит столько же, сколько 1K ($0.045).
- При точных пикселях в
sizeучитывается фактическая площадь;resolutionне влияет (напримерsize: "2048x2048"→ $0.09). - Первое референс-изображение бесплатно; каждое следующее — с надбавкой.
- При сбое задачи — полный автоматический возврат.
Предавторизация и расчёт декомпозиции на слои
Поскольку при отправке задачи конечное число и размеры слоёв неизвестны, предавторизация использует консервативные правила по параметрам запроса:- Точные пиксели: уровень по запрошенной площади в пикселях.
1K/1.5K: предавторизация на уровне 1K.2K: предавторизация на уровне 2K.auto: может выводить до 2K, поэтому предавторизуется на уровне 2K.
Пример: вход
1080×1080 разлагается на 10 изображений. Задача предавторизуется как 17 изображений × уровень 2K. Если все 10 итоговых изображений содержат не более 2,61 млн пикселей, расчёт идёт как 10 изображений × уровень 1K, а остаток средств возвращается автоматически.Типичные ошибки
⏱️ Более медленная генерация: около 90 с для 1K и 160 с для 2K (приоритет качества). Опрашивайте статус задачи каждые 5–10 секунд и установите тайм-аут клиента на 5 минут. Своевременно сохраняйте созданные результаты.
Ответ
integer
Код состояния ответа
array
Массив данных ответа