Краткий вывод
- Вызов асинхронного API изображений с model=doubao-seedream-5-5.
- size принимает ступени 1K/1.5K/2K или явный размер WxH в диапазоне 921 600-4 624 220 пикселей.
- metadata.background=transparent возвращает RGBA PNG. max_images ограничивает общее число слоёв вместе с базой: 2-100, по умолчанию 30.
Ключевые параметры
- model | string | обяз. | doubao-seedream-5-5 | - | Используйте doubao-seedream-5-5 как точный идентификатор модели.
- prompt | string | опц. | - | - | Обязателен для генерации и редактирования; необязателен при layer_decomposition=true.
- size | string | опц. | - | 1K | 1.5K | 2K | WIDTHxHEIGHT | Для генерации используется разрешение модели, для слоёв auto. Пресет не фиксирует пропорции; явные размеры должны давать 921600-4624220 пикселей.
- image_urls | string[] | опц. | - | 0-10 | Передайте 1-10 референсов JPEG, PNG или WEBP через image_urls. Локальные файлы сначала загрузите, затем используйте полученные URL.
- n | integer | опц. | 1 | 1 | Укажите 1 или опустите. Обычная генерация возвращает одно изображение; это не число слоёв.
- layer_decomposition | boolean | опц. | false | - | Отключите для обычной генерации. Нужен ровно один референс без metadata.background. Возвращает базу и прозрачные PNG-слои; общий предел задаёт layer_decomposition_options.max_images.
- layer_decomposition_options.max_images | integer | опц. | 30 | 2-100 | Общий предел результатов при разложении, включая базу. Это не гарантированное число: фактическое количество определяет модель.
- layer_decomposition_options.text_recognition | boolean | опц. | - | - | Управляет распознаванием текста при разложении. Результат содержит метаданные text_recognition только тогда, когда их возвращает поставщик.
- metadata.output_format | string | опц. | - | png | jpeg | При пропуске используется формат провайдера, для прозрачности png. При разделении задаёт формат только базы; остальные слои всегда PNG.
- metadata.background | string | опц. | - | auto | opaque | transparent | Только генерация и редактирование. При layer_decomposition=true опустите, даже opaque. transparent возвращает RGBA PNG, jpeg недопустим.
- metadata.watermark | boolean | опц. | - | - | Установите false, чтобы отключить видимый водяной знак.
- metadata.response_format | string | опц. | url | url | b64_json | Форма выдачи результата; рекомендуется url.
Частые ошибки
- 400 invalid_input: триггер=size выходит за пределы пикселей, больше 10 референсов или layer_decomposition не с одним входным изображением.; исправление=Проверьте size, число image_urls и ограничения входа layer_decomposition по документации.; повтор=Повторяйте только после исправления запроса.
- 429 rate_limit_exceeded: триггер=Частота запросов, параллелизм или квота упираются в лимиты.; исправление=Примените экспоненциальную задержку, затем проверьте темп запросов и квоту.; повтор=Используйте задержку 1s/2s/4s с джиттером.










