Seedream 5.5

Используйте модель doubao-seedream-5-5-261028 с POST https://apimaster.ai/v1/images/generations, телом JSON и Authorization: Bearer YOUR_API_KEY. Создайте свой ключ APIMaster в консоли.

Поддерживает генерацию из текста в изображение, редактирование с использованием до десяти референсов, последовательное редактирование, нативный вывод RGBA с прозрачностью, разложение на слои и OCR с форматированным текстом. Обычная генерация возвращает одно изображение. Разложение возвращает основу и отдельные слои. Потоковая передача, последовательная генерация изображений и веб-поиск не поддерживаются. Используйте синхронную конечную точку; установите тайм-аут клиента не менее 300 секунд и избегайте слепой повторной отправки.

Официальное базовое ценообразование

Проверено по ценам Volcengine 2026-11-13. Настроенный курс конвертации — 7 CNY за USD.

Пункт	CNY за изображение	Приблизительная базовая цена в USD
Каждый входной референс, включая первый	0.05	0.00714286
Вывод с шириной × высотой ≤ 2,610,000 пикселей	0.13	0.01857143
Вывод выше 2,610,000 пикселей	0.23	0.03285714

Генерация и разложение используют одинаковые тарифы на вывод. Начисляйте за каждую основу/слой отдельно, используя его фактический data[].size; самая длинная сторона не определяет уровень. 2048x1024 относится к более низкому уровню. Два входа плюс один вывод высокого уровня стоят CNY 0.33 до применения множителей аккаунта/канала. В отличие от Seedream 5.0 Pro, первый референс не является бесплатным. Фактические списания с аккаунта включают применимые коэффициенты канала/группы пользователей и округление целочисленных квот. См. актуальную карточку модели и журналы использования.

Генерация из текста в изображение

curl --max-time 300 "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"doubao-seedream-5-5-261028",
    "prompt":"A cream landscape poster, a red circle, a blue square, heading HELLO SEEDREAM",
    "size":"1.5K",
    "output_format":"png",
    "background":"opaque",
    "response_format":"url",
    "watermark":false
  }'

Параметры

Поле	Тип / значение по умолчанию	Правила
model	обязательная строка	doubao-seedream-5-5-261028.
prompt	строка	Обязательно для генерации; необязательно для разложения. Опишите содержимое, стиль, соотношение сторон, текст или место редактирования. Официальные рекомендации по написанию советуют ≤300 китайских символов или ≤600 английских слов; это рекомендация, а не ограничение по байтам.
image	строка или string[]	Публичный URL или data:image/png;base64,.... До десяти референсов для генерации; ровно один вход для разложения. Локальные пути файловой системы не работают.
size	строка	По умолчанию для генерации — 2K; 1K, 1.5K, 2K или точный размер WIDTHxHEIGHT. По умолчанию для разложения — auto, принимает только auto и эти три уровня.
output_format	строка, png	png или jpeg. Для разложения это управляет только основой; слои всегда PNG.
background	строка, auto	auto, transparent или opaque, только для генерации. Прозрачный вывод требует PNG; полностью пропустите это поле для разложения.
response_format	строка, url	url или b64_json. Читайте соответствующее поле в каждом элементе data[].
watermark	boolean, true	Установите false, чтобы убрать видимый водяной знак AI-генерации.
optimize_prompt_options	объект	Только {"mode":"standard"} поддерживается 5.5; fast не поддерживается.
layer_decomposition	boolean, false	Включить разложение одного PNG/JPEG изображения.
layer_decomposition_options	объект	Параметры разложения ниже.
layer_decomposition_options.max_images	целое число, 30	2–100, включая основу. Максимум, а не гарантированное количество.
layer_decomposition_options.text_recognition	boolean, false	Запросить OCR с форматированным текстом для обычных текстовых слоев.
safety_identifier	строка	Стабильный английский идентификатор пользователя, не более 64 символов; используйте хэш вместо личной контактной информации.

Не используйте resolution, quality, n или seed другой модели для управления этой моделью. Они не указаны в качестве соответствующих элементов управления генерацией в официальном API. Установите ограничения разложения с помощью layer_decomposition_options.max_images.

Размеры и ограничения ввода

Для обычной генерации выберите уровень (1K, 1.5K, 2K) и опишите соотношение сторон в запросе, или укажите точные размеры. Точная площадь вывода должна быть 921,600–4,624,220 пикселей, с соотношением сторон 1:16–16:1, удовлетворяя обоим ограничениям. 2880x1440 допустимо; 512x512 слишком мал. Уровня 4K не существует.

Разложение не принимает точные размеры. При auto размеры основы/слоя в поддерживаемом диапазоне по возможности сохраняют свои исходные размеры; меньшие/большие элементы масштабируются до 1K/2K с сохранением их соотношения сторон. Возвращенные слои могут занимать разные тарифные уровни.

Ограничение ввода	Генерация/редактирование	Разложение
Количество	До 10	Ровно 1
Форматы	JPEG, PNG, WebP, BMP, TIFF, GIF, HEIC, HEIF	PNG, JPEG
Размер файла на изображение	≤30 МБ	≤30 МБ
Площадь в пикселях	196–36,000,000; обе стороны >14 пикс.	262,144–36,000,000
Соотношение сторон	1:16–16:1	1:16–16:1

Используйте MIME-типы в нижнем регистре в data URL. Удаленные URL ввода должны быть доступны сервису.

Редактирование и прозрачные изображения

{
  "model":"doubao-seedream-5-5-261028",
  "prompt":"Keep the layout of the first image; recolor only its circle using the second reference",
  "image":["https://example.com/source.png","https://example.com/reference.png"],
  "size":"1.5K",
  "output_format":"png",
  "watermark":false
}

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

Для нативной генерации с прозрачностью пропустите image, если он не нужен, и установите background: "transparent", output_format: "png", с запросом, например, «полупрозрачная синяя стеклянная бабочка, изолированный объект, прозрачный фон». Редактирование может использовать до десяти референсов; они не обязательно должны уже иметь альфа-каналы. transparent вместе с jpeg недопустимо. background в ответе описывает фактическую прозрачность (transparent или opaque).

Разложение и OCR с форматированным текстом

{
  "model":"doubao-seedream-5-5-261028",
  "image":"https://example.com/poster.png",
  "prompt":"Separate the heading, circle and square into editable layers",
  "layer_decomposition":true,
  "layer_decomposition_options":{"max_images":4,"text_recognition":true},
  "size":"auto",
  "output_format":"png",
  "watermark":false
}

Поддерживает одну основу плюс до 99 слоев. max_images: 4 включает основу. Пропустите background; каждый слой — прозрачный PNG. Сбой отдельного слоя приводит к сбою всего запроса, а не к частичному успеху.

Прочитайте все записи data[]:

• url/b64_json, size и output_format идентифицируют артефакт и его фактические размеры; background доступен где применимо.
• z_index: 0 идентифицирует основу; большие индексы располагаются выше меньших.
• name и description описывают слой.
• bounding_box.absolute — это [left,top,right,bottom] в пикселях выходной основы. Измените размер слоя до (right-left) × (bottom-top) и разместите его в (left,top); размеры файла слоя могут отличаться от его области на холсте.
• bounding_box.normalized использует координаты 0–1000. Умножьте горизонтальные/вертикальные координаты на ширину/высоту целевого холста и разделите на 1000.
• text_recognition появляется только по запросу и когда слой содержит распознанный обычный текст. Рукописный текст, художественные надписи и нетекстовые слои могут его не содержать.

OCR содержит text и lines[]; каждая строка имеет свои bounding_box и стилизованный runs[]. Каждый фрагмент имеет text и style, которые могут содержать similar_font_family, foreground_color (#RRGGBB), bold, italic, underline, strikethrough, shadow и translucent. Это приблизительные визуальные интерпретации, а не точные исходные свойства дизайна; распознавание шрифта может вернуть unknown.

Ответ, хранение и сбои

Ответ содержит created, model, data[], usage.input_images и usage.generated_images. Сгенерированное количество включает основу и слои. Сохраняйте полные метаданные ответа. Исходные URL-адреса для скачивания от провайдера истекают через 24 часов; своевременно скачивайте/архивируйте свои ресурсы.

Исправьте недопустимые размеры, количество референсов или несовместимые параметры прозрачности перед повторной попыткой. Обрабатывайте аутентификацию, разрешения, модерацию, ограничения скорости и сбои вышестоящего сервиса отдельно; никогда не интерпретируйте ошибку как успешную генерацию. Ограничения IPM учитывают сгенерированные изображения на аккаунт/версию модели; разложение резервирует max_images и возвращает неиспользованную емкость после завершения, при этом оплата взимается за фактически созданные изображения.

Официальные источники: Seedream 5.5, API генерации изображений, ценообразование. Параметры проверены 2026-11-13.