Введение
Генерация по тексту Seedream 5.5 создаёт изображение по письменному описанию сцены, в том числе макеты с заданными надписями. Используйте этот эндпоинт Seedream 5.5 API, если начинаете с описания, а не с готовой картинки. Среди примеров — журнальная обложка, меню рамэн, фотографические портреты и товарная графика с прозрачностью.
ByteDance заявляет фотореалистичные результаты, точный мелкий и многоязычный текст и создание PNG с RGBA. Наши тесты показывают конкретные примеры этих возможностей: меню в 2k воспроизвело заданный текст символ в символ, а отдельный PNG в 2k содержал настоящий альфа-канал. При планировании своего макета рассматривайте их как результаты отдельных замеров.
Ключевые возможности и особенности
Генератор изображений с текстом
В примере KAZE RAMEN текст разделён на английский заголовок, японский подзаголовок, четыре позиции и сноску с часами работы. Наши тесты воспроизвели эти надписи в 2k. На обложке NOIR другая иерархия: крупное название журнала, мелкие дополнительные строки и штрихкод. Задавайте точный текст каждого блока, чтобы модели было что размещать.
Управление текстом требует и ограничения допустимых надписей. В одном тесте промпт без запрета дополнительных слов привёл к лишним строкам. Если нужен только заданный текст, заключите каждую строку в кавычки и добавьте прямое указание: «Никаких других слов».
Настройки генератора прозрачных PNG
Пример кружки с лисой описывает глянцевое бирюзовое керамическое изделие с белым логотипом при студийном свете. В настройках выбраны PNG и прозрачный фон. Наш замер в 2k подтвердил альфа-канал, который хранит прозрачность в файле. Выбирайте оба параметра, если графику нужно разместить в другой композиции.
Выбор холста и формата
Для генерации доступны восемь соотношений сторон и четыре ступени разрешения. По умолчанию холст квадратный, разрешение — 2k. Выбирайте форму под место размещения, не ожидая, что её определит описание сцены.
| Параметр | Доступные значения | По умолчанию |
|---|---|---|
aspect_ratio | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9 | 1:1 |
| resolution | 1k, 1.5k, 2k, 4k | 2k |
output_format | png, jpeg | png |
| background | auto, transparent, opaque | auto |
На ступени 4k формат 16:9 даёт 3840 x 2160 пикселей, а 1:1 — 2880 x 2880. Эти размеры относятся к указанным настройкам. JPEG непрозрачен, поэтому сохраняйте PNG, если задача требует прозрачности.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Пока действует модерация; версия без модерации появится скоро. Некоторые запросы отклоняются без оплаты. Не менее 1 символов · Не более 5000 символов |
aspect_ratio | Нет | Задаёт соотношение сторон холста: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 или 21:9. По умолчанию — 1:1. |
resolution | Нет | Задаёт оплачиваемую ступень разрешения: 1k, 1.5k, 2k или 4k; по умолчанию — 2k. От неё зависит оплата, причём тарифы 1k и 1.5k совпадают. |
output_format | Нет | Выбирает формат png или jpeg; по умолчанию — png. Формат не влияет на оплату. |
background | Нет | Управляет фоном: auto, transparent или opaque; по умолчанию — auto. Для альфа-канала выберите transparent вместе с png. |
Стоимость
Оплата сгенерированного изображения зависит от ступени разрешения. Тарифы 1k и 1.5k совпадают; соотношение сторон, формат и фон не добавляют плату.
| Спецификация | Стоимость |
|---|---|
| $0.0195 / изображение |
| $0.0195 / изображение |
| $0.027 / изображение |
| $0.0525 / изображение |
Сценарии использования
Меню с готовым многоязычным текстом
Начните с выверенных формулировок меню и задайте каждой строке место. По структуре KAZE RAMEN отделите название заведения от подзаголовка, позиций и мелкой сноски. Перед использованием изображения сверьте надписи с исходным текстом. Замер меню подтверждает этот пример, но не обещает тот же результат для любой расстановки текста.
Журнальная обложка с ясной иерархией
Опишите сцену для обложки, затем отделите название журнала от дополнительных надписей. Пример NOIR задаёт нужные строки в кавычках и запрещает другие слова. Используйте этот приём, если заголовок должен остаться точным. Опишите относительный размер и положение каждого блока, чтобы все надписи не оказались равнозначными.
Фотографические сцены с конкретными указаниями
В портрете у моря нужный образ задают льняная рубашка, сумеречный свет и плёночное зерно. Пример джаз-бара называет двух участников, их одежду, медленный танец и янтарное освещение помещения. Описывайте сцену столь же конкретно: кто в ней присутствует, где находится, что носит и каким должен быть свет.
Товарная графика для другого макета
Опишите материал кружки, цвет, логотип и ракурс, затем выберите прозрачность в настройках результата. Формулировка «изолированное изображение товара» поясняет композицию. Параметр background определяет, будет ли PNG содержать прозрачность. Согласуйте описание товара с настройками файла.
Руководство по промптам и практические советы
Сначала сцена, затем оформление
Начните с главного объекта и обстановки. Затем добавьте важные материалы, цвета, освещение и фотографическую обработку. Например: «Бирюзовая керамическая кружка с белым логотипом лисы, мягкий студийный свет». Это даёт конкретные визуальные указания без посторонних объектов и выдуманных надписей.
Заключайте нужные строки в кавычки
Используйте короткие обозначения ролей: «Название журнала: 'NOIR'» или «Заголовок: 'KAZE RAMEN'». Сноску задайте отдельным указанием, чтобы отличить её от заголовка. Соединяйте текст с положением: «Разместите 'NOIR' крупным шрифтом с засечками над фотографией». Сразу дайте текст на нужном языке, не поручая модели придумывать перевод.
Ограничьте набор надписей
После текста в кавычках добавьте: «Используйте только заданные формулировки, никаких других слов». Этот совет основан на тестах, где отсутствие ограничения приводило к лишнему тексту. После генерации сверьте с промптом каждую строку, включая мелкие пояснения. Уточните инструкцию, если блок пропущен или выполняет другую роль.
Задавайте форму в настройках
Выбирайте 3:4 для вертикальной композиции или 16:9 для широкой сцены, если они подходят макету. Слово «вертикальный» не заменяет aspect_ratio. Без изменения параметра результат использует холст 1:1. Разрешение выбирайте отдельно от формы.
Настраивайте прозрачность явно
Для объекта без фона одновременно задайте output_format png и background transparent. Короткая фраза вроде «изолированное изображение товара» поясняет визуальную цель, но не добавляет альфа-канал в JPEG. Выберите background opaque для непрозрачного результата или оставьте auto, если не определились с режимом фона.
Соблюдайте лимит промпта
Платформа принимает до 5 000 символов в prompt; ByteDance рекомендует не более 600 английских слов. Используйте этот объём для деталей сцены, точных надписей и их размещения. Сохраняйте промпт вместе с выбранным соотношением сторон, ступенью разрешения и скачанным изображением, чтобы вернуться к замыслу при последующих правках.
Другие страницы моделей: Seedream 5.0 Pro и Seedream 5.0 Flash.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.5/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"background": "auto",
"resolution": "2k",
"aspect_ratio": "1:1",
"output_format": "png"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
