Генерация и редактирование изображений Seedream

Обзор

Seedream — это флагманская серия моделей генерации изображений от ByteDance BytePlus ModelArk с единой архитектурой генерации и редактирования: генерация по тексту, редактирование одного изображения, объединение нескольких изображений и пакетная генерация серий изображений выполняются через один эндпоинт /v1/images/generations — различаются только параметры. APIYI поддерживает стратегическое партнерство с BytePlus и интегрирует каждую активную версию в день релиза.

🎨 Главные особенности: новая модель 5.0 Flash стоит $0.018 за запрос и возвращает результат примерно за 15–20 секунд, обеспечивая качественную композицию и отрисовку текста для масштабной генерации материалов; вся серия поддерживает единую интеграцию + разрешение 4K на выходе + до 10 референсных изображений для объединения + пакетный режим (вход + выход ≤ 15) + передовую отрисовку текста. Идеально подходит для главных изображений в e-commerce, рекламных постеров, предметной фотосъемки и создания контента — везде, где важны высокое качество и читаемый текст.

Все API для работы с изображениями являются синхронными — здесь нет task ID для периодического опроса, и в случае разрыва соединения со стороны клиента результат будет утерян, тогда как за запрос всё равно будет произведена тарификация. Установите достаточно большой таймаут для этой модели; см. Основы и лучшие практики API генерации изображений.

Какая именно это версия Seedream? APIYI предоставляет Seedream на базе официальных зарубежных (международных) ресурсов BytePlus, а не версии Doubao / Volcengine для материкового Китая. В международной редакции действует сравнительно более мягкая политика модерации контента по сравнению с версией для внутреннего рынка, что обеспечивает большую творческую свободу — реальное преимущество данной платформы. Однако это не означает полное отсутствие модерации: BytePlus по-прежнему выполняет встроенные проверки безопасности контента, и нарушающие правила prompt или референсные изображения отклоняются с кодом ошибки 400/403 (отклоненные запросы не тарифицируются). Соблюдайте правила использования сервиса.

API генерации изображений по тексту

POST /v1/images/generations. Генерация изображений по prompt в разрешениях 1K / 2K / 3K / 4K или с точными размерами в пикселях.

API редактирования изображений

Тот же эндпоинт с параметром image. Редактирование одного изображения, объединение нескольких изображений и пакетная серия (до 15 изображений).

История версий

Сравнение характеристик 5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0, различия в тарификации и руководство по миграции.

Доверьте интеграцию ИИ-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

Сначала он получает текстовую версию этой страницы (добавьте .md к любому URL документации), а затем пишет код под стек вашего проекта: таймауты, мгновенный рехостинг URL-результатов, редактирование через массив URL вместо multipart, а также параметры, которые отклоняет seedream-5-0-pro, уже заложены в требования.

Интегрируйте / проведите отладку генерации изображений по тексту и редактирования изображений Seedream в этом проекте.

Изучите документацию, прежде чем приступать к коду: запросите https://docs.apiyi.com/en/api-capabilities/seedream-image/overview.md для получения текстовой версии этой страницы. Для более подробной информации о параметрах добавьте .md к …

Таймаут: настройте таймаут клиента по уровням в зависимости от модели — начните с 60 секунд для серии 4.x и seedream-5-0-flash (для flash требуется около 30 секунд при 10 референсных …

Всего 7 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.

От каких проблем избавляет этот prompt

Требование	Предотвращаемая проблема
Редактирование не использует multipart	В Seedream нет `/v1/images/edits`; референсные изображения передаются как JSON-массив URL, поэтому подход с multipart в стиле OpenAI заведомо завершится ошибкой
Мгновенный рехостинг на стороне сервера	Срок действия ссылки вышестоящего сервиса истекает примерно через 24 часа, поэтому её долговременное хранение приводит к постепенному появлению ошибок 404
Таймаут с градацией по моделям	`seedream-5-0-pro` выполняется около 2 минут, поэтому 60-секундный таймаут будет постоянно срабатывать — причём тарификация прерванного запроса всё равно происходит. См. Основы и лучшие практики Image API
Два запрещенных поля для `5-0-pro` / `5-0-flash`	`sequential_image_generation` возвращает 400 даже со значением `"disabled"` — самая частая ловушка при переносе кода с другой версии
Не полагайтесь на `n`	Параметр молча игнорируется и всё равно возвращает одно изображение; используйте вместо него `sequential_image_generation`
Передавайте `watermark` со значением false	Значение по умолчанию зависит от версии, поэтому результат для коммерческого использования может прийти с водяным знаком

Почему Seedream от APIYI

Прямая замена официального канала BytePlus ModelArk, оптимизированная для промышленной эксплуатации по трем направлениям — стабильность, затраты, интеграция:

Стратегическое партнерство · стабильные ресурсы

Авторизованное прямое подключение к BytePlus ModelArk. Поведение запросов и ответов полностью идентично апстриму — без обхода протоколов, безопасно для продакшена.

Неограниченные параллельные запросы · корпоративный уровень

Линейное масштабирование для пакетной генерации, объединения нескольких изображений и последовательной генерации — без ограничений аккаунта по уровням (Tier). По умолчанию 500 RPM, обратитесь в отдел продаж для увеличения квот.

Та же цена + скидка до 20% при пополнении

Базовая цена за единицу совпадает с официальными тарифами BytePlus. В сочетании с бонусами за пополнение фактическая цена снижается вплоть до 80% от базовой стоимости (для 5.0 Flash — примерно на 9%–17% ниже официальной цены).

Беспрепятственный глобальный доступ

Зарубежный сервер или прокси не требуются. Прямое подключение к api.apiyi.com из дата-центров материкового Китая, резидентных сетей и зарубежных узлов. Настраивать маршрутизацию для регионов BytePlus ap-southeast-1 / eu-west-1 не требуется.

Совместимость с OpenAI · без изменений в коде

Путь /v1/images/generations полностью идентичен OpenAI. Укажите в base_url OpenAI SDK адрес APIYI и вызывайте API без изменений. Передавайте дополнительные параметры (image / sequential_image_generation и т. д.) через extra_body. Обратите внимание, что параметр OpenAI n не поддерживается апстримом (он молча игнорируется — вы все равно получите 1 изображение); для вывода нескольких изображений используйте sequential_image_generation.

Профессиональная поддержка · консьерж-сервис для корпоративных клиентов

Глубокая экспертиза в сценариях генерации изображений — объединение нескольких изображений, рендеринг текста, пакетное создание ассетов. Комплексная поддержка от этапа PoC до внедрения в продакшен.

Ключевые особенности

Высокодетализированный вывод в 4K

Версии 4.0 / 4.5 поддерживают нативное разрешение 4K (4096×4096) с множеством детализированных слоёв — идеальный вариант для постеров и печати. Максимальное разрешение версии 5.0-lite — 3K, но она предлагает более проработанный пользовательский опыт.

Единая генерация и редактирование

Генерация изображений по тексту, редактирование одного изображения, слияние нескольких изображений и последовательная пакетная генерация используют один эндпоинт и один набор параметров. Переключайте режимы с помощью image и sequential_image_generation.

Слияние нескольких изображений · до 10 референсов

image принимает массив URL. Чтобы указать порядок, используйте в prompt фразы «изображение 1 / изображение 2». Для слияния с сохранением сходства объектов используйте sequential_image_generation: "disabled".

Прорыв в отображении текста

В версии 4.5 значительно повысилась разборчивость мелкого текста. Текст на постерах, рекламные надписи и текст на товарах отображаются чётко и точно — лучше, чем у аналогов.

Последовательная пакетная генерация (до 15 изображений)

sequential_image_generation: "auto" вместе с max_images создаёт связную серию — отличный вариант для раскадровок, фирменных изображений и серий товаров.

≈ 15 с на изображение · сбалансированная скорость

Типичная задержка при генерации одного изображения составляет ~15 с; генерация в 4K + hd может занимать до минуты. По умолчанию доступно 500 RPM, при необходимости лимит можно увеличить.

Гибкие размеры · произвольное соотношение сторон

Предустановленные разрешения (1K/2K/3K/4K) или точные значения в пикселях. Общее количество пикселей ∈ [1280×720, 4096×4096], соотношение сторон ∈ [1/16, 16].

Подключение через OpenAI SDK без изменений кода

Укажите base_url=https://api.apiyi.com/v1 и вызывайте API с помощью официального OpenAI SDK. Дополнительные параметры передаются через extra_body. Для миграции не требуется менять код.

Примеры результатов

Генерация изображений по тексту · главное изображение для электронной коммерции (seedream-5-0-flash; только prompt: светло-зелёный флакон сыворотки на чистом белом фоне, китайская надпись 新品首发 в правом верхнем углу и 限时 8 折 под ней): 17,1 с; китайские надписи в разрешении 2K выполнены с точной передачей штрихов, без ошибок в символах; форма флакона и коммерческое освещение выглядят безупречно.

Пример генерации изображений по тексту в Seedream 5.0 Flash: главное изображение флакона сыворотки на белом фоне с чёткими китайскими надписями

Редактирование изображения · новый фон и ценник (seedream-5-0-flash; референс — вид сверху на рамэн, prompt: замените фон на стол из тёмного дерева и добавьте в верхней правой части миски ценник на китайском 招牌豚骨 38 元): 33,2 с; в тексте ценника нет ошибок в символах, рамэн, топпинги и пар остались без изменений, а тёмное дерево подчёркивает основной объект.

Пример редактирования в Seedream 5.0 Flash: фон с рамэном заменён на тёмное дерево, добавлен ценник на китайском

Тарификация

Тарификация за каждое изображение, такая же цена, как у официального BytePlus. Бонусы за пополнение дополнительно снижают фактическую цену за единицу.

Модель	Цена APIYI	Официальная цена (прим. в RMB)	Статус
`seedream-5-0-flash-260915`	$0.018 / запрос (1 изображение)	≈ ¥0.126 / запрос	🆕 Новейшая · быстрый уровень (~15–20 с на изображение, самая доступная в серии)
`seedream-5-0-pro-260628`	$0.12 / запрос (1 изображение)	≈ ¥0.84 / запрос	Уровень Pro (~2 мин на изображение; используйте 5.0-lite для повседневных задач)
`seedream-5-0-260128`	$0.035 / изображение	≈ ¥0.245 / изображение	✅ Рекомендуется
`seedream-4-5-251128`	$0.04 / изображение	≈ ¥0.28 / изображение	✅ Рекомендуется
`seedream-4-0-250828`	$0.03 / изображение	≈ ¥0.21 / изображение	🟡 Поддерживается (по-прежнему доступна для вызова)

Примечания по тарификации:

Тарификация за каждое сгенерированное изображение, независимо от длины prompt или режима объединения
seedream-5-0-flash тарифицируется по фиксированной цене $0.018 за запрос, аналогично официальным ценам BytePlus, а референсные изображения бесплатны (в наших тестах 1, 3 и 10 референсных изображений тарифицировались по $0.018)
seedream-5-0-pro тарифицируется по фиксированной цене $0.12 за запрос (1 изображение за запрос; пакетная последовательность не поддерживается). Официально модель использует два ценовых уровня в зависимости от выходного разрешения (одна цена для ≤2.36M px, другая для >2.36M px), а также дополнительную плату за каждое референсное изображение сверх первого; APIYI упрощает это до единой фиксированной цены за запрос — без уровней, плата за входные изображения включена. Для этой модели не предусмотрено никаких официальных скидок; APIYI устанавливает цену исходя из гарантии доступности ресурсов — фактически с нулевой маржой с учётом бонусов за пополнение и налоговых расходов — и о любых изменениях цен будет объявлено заранее
В режиме sequential_image_generation: "auto" тарификация осуществляется по фактическому количеству результатов (например, если max_images: 4 возвращает 4 → тарифицируются 4)
Неудачные запросы (ошибки 4xx / блокировка модерацией) не тарифицируются
Пробный период: 200 бесплатных изображений при первом подключении (предоставляются BytePlus)
Подробнее о бонусах за пополнение: см. Акции по пополнению

Технические характеристики

Параметр	seedream-5-0-flash	seedream-5-0-pro	seedream-5-0	seedream-4-5	seedream-4-0
ID модели	`seedream-5-0-flash-260915`	`seedream-5-0-pro-260628`	`seedream-5-0-260128`	`seedream-4-5-251128`	`seedream-4-0-250828`
Псевдоним ID модели	—	—	`seedream-5-0-lite-260128`	—	—
Дата выпуска	2026-09-15 (UTC+8)	2026-06-28 (UTC+8)	2026-01-28 (UTC+8)	2025-11-28 (UTC+8)	2025-08-28 (UTC+8)
Уровни разрешения	1K / 1.5K / 2K + точные WxH (всего 0,92M–4,62M пикс., соотношение сторон ≤ 16:1)	1K / 2K + точные WxH (всего ≤ 4,19M пикс.; при 16:9 длинная сторона достигает 2720, ~2,7K)	2K / 3K	2K / 4K	1K / 2K / 4K
Формат вывода	`png` / `jpeg` (прозрачные слои через разделение на слои)	`png` / `jpeg`	`png` / `jpeg`	`jpeg`	`jpeg`
Оптимизация prompt	стандартная	стандартная / быстрая	стандартная	стандартная	стандартная / быстрая
Текст в изображение	✅	✅	✅	✅	✅
Редактирование одного изображения	✅	✅	✅	✅	✅
Объединение нескольких изображений	✅ (до 10)	✅ (до 10)	✅	✅ (до 10)	✅
Пакетная последовательность	❌ (400 при передаче)	❌ (400 при передаче)	✅	✅	✅
Потоковая передача вывода	❌ (400 при передаче)	❌ (400 при передаче)	✅	✅	✅
Максимум изображений в минуту (RPM)	500	500	500	500	500
Вход + выход в одном запросе	вход ≤ 10, выход 1	вход ≤ 10, выход 1	≤ 15	≤ 15	≤ 15
Типичная задержка	15–20 с	~2 минуты	~30 с	10–20 с	10–15 с
Поле ответа	аналогично	аналогично	`data[].url` или `data[].b64_json`	аналогично	аналогично

Сравнение времени генерации

Измеренная задержка одиночного запроса для каждой версии (замеры: 2026-07, 5.0 Flash — 2026-09-24, UTC+8; астрономическое время от запроса до получения полного ответа — ожидаются естественные отклонения между запросами):

Сценарий	seedream-4-0	seedream-4-5	seedream-5-0	seedream-5-0-pro	seedream-5-0-flash
Текст в изображение (1K/2K)	7-11 с	8-13 с	29-34 с	110-130 с	14-20 с
Текст в изображение (максимальное качество)	~15 с (4K)	~18 с (4K)	~37 с (3K)	~134 с (ШxВ 2720×1530, макс. размер)	~19 с (ШxВ 2688×1712, макс. размер)
Редактирование / объединение нескольких изображений	~11 с	17-21 с	38-40 с	115-132 с	~16 с (1-3 изображения) / ~28 с (10 изображений)
Пакетная последовательность (2 изображения, редактирование + авто)	—	~36 с	—	— (не поддерживается)	— (не поддерживается)
Рекомендуемый таймаут клиента	≥ 60 с	≥ 60 с	≥ 120 с	≥ 240 с	≥ 60 с

seedream-5-0-pro стабильно занимает ~2 минуты на изображение (110-132 с по результатам всех замеров без исключения). Это ожидаемое поведение для модели генерации изображений с глубоким рассуждением, а не сбой. Прежде чем переходить на pro, убедитесь, что ваш продукт способен справиться с такой задержкой: интерактивные сценарии (когда пользователь ожидает у экрана) подходят плохо — вместо этого используйте 5.0-lite (~30 с); pro подходит для офлайн-пакетной генерации, где важнее всего качество изображений и соблюдение инструкций.

Эндпоинты API

Эндпоинт	Назначение	Content-Type
`POST /v1/images/generations`	Генерация изображений по тексту / редактирование одного изображения / объединение нескольких изображений / пакетная последовательность — для всех режимов используется один эндпоинт, переключение осуществляется через параметры тела запроса	`application/json`

Выбор домена: api.apiyi.com является основным эндпоинтом. b.apiyi.com и другие домены шлюза также доступны с идентичным поведением. Вам не нужно использовать нативные домены BytePlus, такие как ark.ap-southeast.bytepluses.com / ark.eu-west.bytepluses.com, — APIYI нормализует все пути к совместимым с OpenAI.

Подробный обзор ключевых параметров

`size` (размер вывода)

Два семейства значений — выберите одно: Предустановленные уровни (модель определяет соотношение сторон):

Уровень	Прибл. пикселей	Поддерживается в
`1K`	~1024×1024	4.0 / 5.0-pro / 5.0-flash
`1.5K`	~1536×1536	только 5.0-flash
`2K`	~2048×2048 (по умолчанию)	все версии
`3K`	~3072×3072	только 5.0
`4K`	~4096×4096	4.5 / 4.0

Точные пиксели (пользовательские):

Общее количество пикселей ∈ [1280×720, 4096×4096]
Соотношение сторон ∈ [1/16, 16]
По умолчанию: 2048x2048

Допустимые примеры: 1920x1080 (FullHD), 3840x2160 (альбомная 4K), 1080x1920 (портретная для телефона), 2560x1440 (альбомная 2K) Недопустимые примеры: 5000x5000 (превышение лимита), 100x1600 (соотношение меньше 1/16)

Размеры с общим числом пикселей свыше 4096×4096 возвращают 400. Экстремальные соотношения сторон (близкие к 1/16 или 16) могут растягиваться неестественно — отдавайте предпочтение предустановкам или стандартным 16:9 / 9:16 / 1:1.Модели серии 5.0 используют другой диапазон точных пикселей, чем 4.x (более высокий нижний предел, более низкий верхний предел). Размеры вне допустимого диапазона возвращают 400 с указанием допустимого диапазона в сообщении об ошибке. Измеренные ориентиры: нижний порог 5.0-lite составляет около 2560×1440; 5.0-pro ограничен 4,19 млн пикселей в сумме (максимум 2048×2048; при 16:9 длинная сторона достигает 2720×1530 ≈ 2,7K, работоспособность проверена) — предустановок 3K/4K нет. 5.0-flash принимает 921 600–4 624 220 пикселей в сумме (около 0,92 млн–4,62 млн) с соотношением сторон до 16:1, также без предустановок 3K/4K; при использовании предустановок модель выбирает соотношение сторон на основе контента, поэтому передавайте точные пиксели, если вам требуется фиксированное соотношение.

`image` и `sequential_image_generation` (переключатели режимов)

Эндпоинт /v1/images/generations охватывает как генерацию изображений по тексту, так и редактирование/объединение. Два параметра вместе определяют режим:

Режим	`image`	`sequential_image_generation`	Примечания
Генерация только по тексту	не указан	не указан или `"disabled"`	1 результат
Редактирование одного изображения	`["url1"]`	`"disabled"`	Редактирование на основе 1 референса
Объединение нескольких изображений	`["url1", "url2", ...]`	`"disabled"`	До 10 референсов; обращение как «image 1 / image 2»
Пакетная последовательность	опционально	`"auto"` + `sequential_image_generation_options.max_images`	N согласованных результатов, N ≤ max_images и input + output ≤ 15

seedream-5-0-pro и seedream-5-0-flash не принимают параметр sequential_image_generation — передача любого значения (включая "disabled") возвращает 400. Для редактирования / объединения с этими двумя моделями передавайте только image и полностью опускайте этот параметр; то же самое относится к stream.

Полные примеры кода см. в разделах Генерация изображений по тексту и Редактирование изображений.

Лучшие практики

Выбирайте подходящую версию

Большие объемы / постерная верстка / скорость и стоимость → seedream-5-0-flash-260915 ($0.018/запрос, ~15–20 с, примерно до 2K)
Лучший универсальный вариант → seedream-5-0-260128 (максимум возможностей, но ограничение до 3K)
4K + качественный рендеринг текста → seedream-4-5-251128 (4K + прорыв в работе с текстом)
4K + лучшая цена → seedream-4-0-250828 (самый доступный 4K)
Максимальное качество изображения / сложные инструкции (профессиональная работа) → seedream-5-0-pro-260628 ($0.12/запрос, ~2 мин на изображение, только 1K/2K — не рекомендуется для повседневного использования)

Отдавайте предпочтение предустановленным размерам

1K/2K/3K/4K оптимизированы BytePlus для стабильной скорости и качества. Задавайте точные размеры в пикселях только при наличии строгих требований к соотношению сторон. Обратите внимание на различия поддерживаемых уровней разрешения в зависимости от версии.

Явно ссылайтесь на изображения

При использовании нескольких URL image составляйте prompt с явными указаниями — «Помести человека с изображения 1 в сцену с изображения 2, используя цветовую палитру изображения 3» — вместо того чтобы позволять модели строить догадки.

Контролируйте расходы на пакетные серии

sequential_image_generation: "auto" + max_images: 4 генерирует 4 изображения — тарификация × 4. Сначала выполните проверку с max_images: 1, а затем увеличивайте объем.

Выбирайте выходной формат в зависимости от задачи

Серия 5.0 поддерживает png и jpeg; 4.5 / 4.0 — только jpeg. Используйте png, когда требуется детализация без потерь (у 5.0-flash в png нет альфа-канала при прямой генерации; используйте разделение слоев для прозрачности), и jpeg — для сценариев, чувствительных к размеру файла.

Устанавливайте таймаут клиента ≥ 60 секунд

Генерация одного изображения занимает ~15 с, но пакетная серия (4 изображения) или 4K + hd может занять 30–60 с. Начните с таймаута клиента в 60 с и отображайте ход выполнения в интерфейсе. seedream-5-0-pro занимает ~2 минуты на изображение — используйте таймаут от 240 с и выше.

Отключайте водяной знак при необходимости

Установите watermark: false, чтобы удалить водяной знак BytePlus (значения по умолчанию различаются в зависимости от версии, поэтому задавайте его явно). Это необходимо для коммерческих материалов.

Коды ошибок и повторные попытки

Статус	Значение	Рекомендуемое действие
`400`	Недопустимые параметры (размер вне допустимых границ, массив `image` > 10, неподдерживаемый tier)	Проверьте соответствие поддерживаемому tier используемой версии
`401`	Недопустимый token	Проверьте Bearer Token
`403`	Заблокировано модерацией контента	Скорректируйте prompt или замените референсные изображения
`429`	Лимит запросов (по умолчанию 500 RPM) или недостаточный баланс	Экспоненциальная задержка; обратитесь в отдел продаж для более высокого RPM
`5xx`	Ошибка шлюза / вышестоящего сервиса	Повторите 1-2 раза
Timeout	Долгий запрос	Таймаут клиента ≥ 60s (batch sequence или 4K + hd могут достигать 60s)

Рекомендации для клиента:

Начните с таймаута запроса 60 секунд (batch sequence или 4K + hd могут занимать до минуты)
Применяйте экспоненциальную задержку для 5xx и таймаутов (рекомендуется 2 повторные попытки)
Логируйте заголовок ответа x-request-id для обращений в поддержку

Часто задаваемые вопросы

5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 — что выбрать?

Потребность	Рекомендуется
Большие объемы / макеты постеров / скорость и стоимость	`seedream-5-0-flash-260915` ($0.018/запрос, ~15–20 с)
Новейшие функции + лучший универсальный вариант	`seedream-5-0-260128`
4K + качественный рендеринг текста (постеры, реклама)	`seedream-4-5-251128`
4K + лучшая цена	`seedream-4-0-250828`
Длительное стабильное пакетное производство	`seedream-4-0-250828` (проверенная, самая дешевая, быстрый режим prompt)
Максимальное качество изображений / сложные инструкции (профессиональная работа)	`seedream-5-0-pro-260628` ($0.12/запрос, ~2 мин на изображение — пропускайте, если в этом нет необходимости)

См. Исторические версии для полного сравнения.

Почему для редактирования изображений также используется эндпоинт генерации?

Seedream использует единую архитектуру генерации и редактирования — здесь нет отдельного эндпоинта /v1/images/edits. В отличие от gpt-image-2 от OpenAI (загрузка multipart на /v1/images/edits), Seedream использует application/json и передает URL изображений в виде массива в поле image.Преимущества: согласованность протокола, повторное использование параметров, простое переключение режимов. Подробности см. в разделе Редактирование изображений.

Принимает ли поле image формат base64?

Да (проверено тестированием). Используйте data URI: data:image/<format>;base64,<base64 string> с <format> в нижнем регистре (например, data:image/jpeg;base64,...). URL и записи base64 можно совмещать в одном массиве. По возможности отдавайте предпочтение публичным URL: URL загружаются сервисом BytePlus напрямую из Сингапура, минуя шлюз APIYI, тогда как тело запроса с base64 должно быть сначала полностью загружено через границу. При низкой скорости соединения тела запросов размером более 20 МБ могут превысить установленный провайдером 600-секундный таймаут на передачу тела запроса, а шлюз не преобразует base64 в URL за вас. См. предупреждение в верхней части страницы редактирования изображений.

Лимит объединения нескольких изображений? Лимит пакетной последовательности?

Объединение нескольких изображений (массив image): 4.5 / 5.0-pro / 5.0-flash явно поддерживают до 10 (в наших тестах 11-е изображение возвращает 400 на 5.0-flash). 5.0 / 4.0 также поддерживают объединение нескольких изображений, хотя явное ограничение не задокументировано.
Пакетная последовательность (max_images): ограничена глобальным правилом входные референсы + выходные изображения ≤ 15. При совмещении объединения и последовательности учитывайте общее количество. Обратите внимание: 5.0-pro и 5.0-flash не поддерживают пакетную последовательность (передача sequential_image_generation возвращает 400).

Нужен ли префикс data:image для b64_json?

Зависит от response_format:

response_format: "url" (по умолчанию) → data[0].url — временный подписанный URL, отображайте напрямую с помощью <img src=...>
response_format: "b64_json" → data[0].b64_json — обычная строка base64 (без префикса data:image/...;base64,). Декодируйте и запишите на диск либо добавьте префикс вручную для отображения в браузере.

Поддерживается ли потоковая передача вывода?

Поддерживается в 5.0 / 4.5 / 4.0 через stream: true. Потоковая передача особенно полезна для длинных prompt и изображений высокого разрешения — фронтенд может отображать промежуточные результаты по мере поступления. seedream-5-0-pro и seedream-5-0-flash не поддерживают потоковую передачу — передача stream возвращает 400.

Лимит запросов?

По умолчанию 500 изображений в минуту (Max Images per Minute), единый для всех версий. Для увеличения квоты свяжитесь с отделом продаж.

Тарифицируются ли неудачные запросы?

Нет. В BytePlus встроена модерация. Отклонения модерацией и ошибки параметров возвращают 400 / 403 и не тарифицируются. Другие нетарифицируемые ошибки: 401 (недействительный token), 429 (превышен лимит запросов). Тарифицируется только успешная генерация (200 с валидным ответом).

Можно ли использовать официальный SDK OpenAI?

Да, без каких-либо изменений в коде. Направьте base_url на https://api.apiyi.com/v1 и передавайте параметры расширения (image / sequential_image_generation / watermark и т. д.) через extra_body:

from openai import OpenAI

client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
resp = client.images.generate(
    model="seedream-5-0-260128",
    prompt="...",
    size="2K",
    extra_body={
        "image": ["https://.../ref.png"],
        "sequential_image_generation": "disabled",
        "watermark": False,
    }
)

Кому принадлежат сгенерированные изображения?

Сгенерированные изображения можно использовать в коммерческих и некоммерческих целях. Подробности см. в условиях обслуживания BytePlus.

Поддерживается ли прозрачный фон?

seedream-5-0 / seedream-5-0-pro поддерживают вывод png и могут формировать прозрачный фон при указании в prompt («transparent background, alpha channel»). seedream-5-0-flash не возвращает альфа-канал даже при запросе прозрачного фона; используйте layer_decomposition: true, чтобы получить базовый фон плюс несколько прозрачных слоев (тарифицируется за каждое выходное изображение), см. Редактирование изображений. seedream-4-5 / 4-0 выводят только jpeg и не поддерживают прозрачность — удаляйте фон самостоятельно на этапе постобработки.

Можно ли отменить генерацию в процессе выполнения?

Нет. /v1/images/generations является синхронным. После отправки запрос выполняется до завершения. Сервер всё равно завершит обработку и тарифицирует запрос, даже если клиент отключится. Настройте таймауты на стороне клиента и избегайте предположения, что отключение сэкономит средства.

Связанная документация

Песочница Text-to-Image — POST /v1/images/generations с примерами кода на пяти языках
Песочница редактирования изображений — паттерны image + sequential_image_generation
История версий — 5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0: сравнение и миграция
Справочник по API — общее руководство по вызовам
Песочница генерации изображений — протестируйте онлайн
Официальная документация BytePlus: docs.byteplus.com/en/docs/ModelArk/1824121 — руководство по Seedream 4.0-5.0

Seedream предоставляется в рамках стратегического партнерства APIYI с BytePlus ModelArk. Все версии используют единый путь интеграции и аутентификации — выбирайте в соответствии с вашими потребностями. Если у вас возникли вопросы или обратная связь, создайте тикет в консоли.

​Обзор

API генерации изображений по тексту

API редактирования изображений

История версий

​Доверьте интеграцию ИИ-агенту

​Почему Seedream от APIYI

Стратегическое партнерство · стабильные ресурсы

Неограниченные параллельные запросы · корпоративный уровень

Та же цена + скидка до 20% при пополнении

Беспрепятственный глобальный доступ

Совместимость с OpenAI · без изменений в коде

Профессиональная поддержка · консьерж-сервис для корпоративных клиентов

​Ключевые особенности

Высокодетализированный вывод в 4K

Единая генерация и редактирование

Слияние нескольких изображений · до 10 референсов

Прорыв в отображении текста

Последовательная пакетная генерация (до 15 изображений)

≈ 15 с на изображение · сбалансированная скорость

Гибкие размеры · произвольное соотношение сторон

Подключение через OpenAI SDK без изменений кода

​Примеры результатов

​Тарификация

​Технические характеристики

​Сравнение времени генерации

​Эндпоинты API

​Подробный обзор ключевых параметров

​size (размер вывода)

​image и sequential_image_generation (переключатели режимов)

​Лучшие практики

​Коды ошибок и повторные попытки

​Часто задаваемые вопросы

​Связанная документация

Обзор

Доверьте интеграцию ИИ-агенту

Почему Seedream от APIYI

Ключевые особенности

Примеры результатов

Тарификация

Технические характеристики

Сравнение времени генерации

Эндпоинты API

Подробный обзор ключевых параметров

`size` (размер вывода)

`image` и `sequential_image_generation` (переключатели режимов)

Лучшие практики

Коды ошибок и повторные попытки

Часто задаваемые вопросы

Связанная документация