Seedream-5.5: генерация изображений
Генерация и редактирование в Seedream 5.5: 1K/1.5K/2K, прозрачный PNG и разложение на слои
Для пользователей из материкового Китая: используйте https://toapis.cn в качестве эндпоинта (Base URL). Замените https://toapis.com на https://toapis.cn во всех примерах этого документа.
Используйте doubao-seedream-5-5 для генерации по тексту, редактирования по референсам и разложения на слои. Запрос возвращает ID задачи; результат нужно получить отдельным запросом.
Обычная генерация возвращает одно изображение, а разложение на слои - базовое изображение и слои.
Authorizations
AuthorizationstringзаголовокобязательноВсе API требуют аутентификации Bearer Token
Получите API Key на странице управления API Key
Добавьте в заголовок запроса:
Authorization: Bearer YOUR_API_KEYBody
modelstringтелообязательнопо умолчанию: doubao-seedream-5-5Название модели для генерации изображений
Пример: "doubao-seedream-5-5"
promptstringтелоТекстовое описание, обязательное для обычной генерации и редактирования. При включенном layer_decomposition его можно опустить, чтобы модель сама определила элементы для разделения.
sizestringтелоДопустимы уровни 1K, 1.5K, 2K или размеры в пикселях, например 2048x2048. Уровень не фиксирует пропорции; явный размер обычной генерации должен давать 921600-4624220 пикселей. Обычная генерация использует настроенное разрешение модели, либо 2K, если оно не настроено. При разделении на слои пропуск размера означает auto. В примерах явно указан 2K, это не значение по умолчанию для слоёв.
Разделение на слои принимает только auto, 1K, 1.5K или 2K и сохраняет пропорции исходного изображения. Явные размеры в пикселях в этом режиме не поддерживаются. Для обычной генерации отношение ширины к высоте должно быть от 1/16 до 16.
nintegerтелопо умолчанию: 1Укажите 1 или опустите для одного обычного изображения. Это не число слоёв; при разделении также опустите или укажите 1.
image_urlsstring[]телоURL референсных изображений для редактирования и работы с несколькими референсами.
- До 10 референсных изображений.
- Только общедоступные HTTP/HTTPS URL; передача base64 напрямую не поддерживается.
- Локальные изображения сначала загрузите через API загрузки изображений.
- Также поддерживаются массивы
reference_imagesиimages. - Максимальный размер каждого референса - 30 MB. Разделение на слои принимает только JPEG или PNG.
imagestringтелоСтрока URL одного референса. Для нескольких изображений используйте image_urls, а не массив в поле image.
layer_decompositionbooleanтелопо умолчанию: falseДля обычной генерации и редактирования изображений опустите этот параметр или задайте false. Если опция включена, отсутствие референса или несколько референсов делают запрос недопустимым.
Значение true разделяет ровно один референс на слои. Поле prompt можно опустить. Не передавайте параметры последовательной генерации. Результат содержит базовое изображение и прозрачные слои PNG с z_index, сведениями о расположении и именами.
layer_decomposition_optionsobjectтелоИспользуйте только при layer_decomposition=true. max_images - целое число от 2 до 100, ограничивающее общее число результатов, включая базовое изображение. По умолчанию 30. Фактическое число определяет модель, оно может быть меньше лимита. text_recognition - логическое значение, по умолчанию false. Объект также можно передать в metadata.layer_decomposition_options.
optimize_prompt_optionsobjectтелоНастройки оптимизации промпта: {"mode": "standard"}. Seedream 5.5 отклоняет fast.
metadataobjectтелоСпецифичные параметры для расширенной настройки модели Seedream 5.5
Свойства metadata
output_formatstringтелопо умолчанию: pngДопустимы png и jpeg, по умолчанию png. Прозрачность требует PNG, JPEG недопустим. При разделении параметр задаёт формат только базы; остальные слои всегда прозрачные PNG.
backgroundstringтелоПри layer_decomposition=true полностью опустите background, даже значение opaque не поддерживается. Этот параметр доступен только для обычной генерации и редактирования изображений.
Допустимы auto, opaque и transparent. Прозрачный фон несовместим с output_format=jpeg. Если при transparent формат не указан, выбирается PNG.
Для обычной генерации значение по умолчанию - auto: модель определяет прозрачность по промпту и формату вывода. JPEG всегда непрозрачен.
watermarkbooleanтелопо умолчанию: falseУправляет видимым водяным знаком AI generated. Значение false отключает его, true включает. Это не означает удаления метаданных происхождения или невидимых меток.
response_formatstringтелопо умолчанию: urlНа этой странице используется режим url. URL изображений доступны в результате асинхронной задачи.
Ограничения параметров
Обычная генерация нескольких изображений не поддерживается. Не передавайте sequential_image_generation и sequential_image_generation_options: вышестоящий API отклоняет даже disabled. Значение stream=true не поддерживается. Опустите stream или используйте false. Текущий API не поддерживает веб-поиск через tools и параметр seed.
Получение задачи
Успешная отправка не означает завершения генерации. Запрашивайте задачу с тем же API Key. Возможные статусы: pending, queued, in_progress, completed, failed. При завершении читайте result.data, при ошибке - error.
curl "https://toapis.com/v1/images/generations/TASK_ID" \
-H "Authorization: Bearer $TOAPIS_API_KEY"Response
idstringУникальный идентификатор задачи для запроса статуса
objectstringТип объекта, всегда generation.task
modelstringНазвание используемой модели
statusstringСтатус задачи
pending,queued- В очередиin_progress- Обрабатываетсяcompleted- Успешно завершенаfailed- Ошибка
progressintegerПрогресс задачи в процентах (0-100)
created_atintegerВременная метка создания задачи (Unix timestamp)
metadataobjectМетаданные задачи
result.dataarrayСписок готовых изображений: один элемент для обычной генерации, несколько для разложения на слои.
result.data[]objectURL изображения, фактический размер в пикселях и формат.
result.data[].z_indexintegerПорядок наложения слоев. 0 обозначает базовое изображение. Остальные слои могут содержать bounding_box, name, description.
result.data[].backgroundstringФактический тип фона, если его вернул поставщик: opaque или transparent. При разделении база имеет фон opaque, остальные слои - transparent. Поле опущено для старых задач и моделей, не возвращающих эти сведения.
result.data[].text_recognitionobjectРезультат распознавания текста для этого слоя, если его вернул поставщик. Поле может отсутствовать даже при включенном text_recognition.
Объект содержит полный text и массив строк lines. Каждая строка содержит bounding_box и runs; runs[].style сохраняет шрифт, цвет и другие сведения поставщика.
Перед запуском задайте переменную окружения TOAPIS_API_KEY. Замените адреса референсов на example.com доступными URL изображений.
Пример запроса
curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "A red toy sailboat and a small yellow sun, isolated objects, no text.",
"size": "2K",
"metadata": {
"output_format": "png",
"background": "transparent",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"prompt": "Combine the subjects from both references into one product illustration.",
"size": "2K",
"image_urls": [
"https://example.com/reference-front.png",
"https://example.com/reference-side.jpg"
],
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'curl --request POST \
--url https://toapis.com/v1/images/generations \
--header "Authorization: Bearer $TOAPIS_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "doubao-seedream-5-5",
"image": "https://example.com/composition.png",
"layer_decomposition": true,
"layer_decomposition_options": {"max_images": 30, "text_recognition": true},
"size": "2K",
"metadata": {
"output_format": "png",
"watermark": false,
"response_format": "url"
}
}'Пример ответа
{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "pending",
"progress": 0,
"created_at": 1794300000,
"metadata": {}
}{
"id": "tsk_img_example",
"object": "generation.task",
"model": "doubao-seedream-5-5",
"status": "completed",
"progress": 100,
"created_at": 1794300000,
"metadata": {},
"result": {
"type": "image",
"data": [
{
"url": "https://files.toapis.com/images/example/seedream-5-5.png",
"size": "2512x1680",
"output_format": "png"
}
]
}
}