Skip to main content

Обзор

Seedream — флагманская серия моделей генерации изображений от ByteDance BytePlus ModelArk, с единой архитектурой генерации и редактирования: преобразование текста в изображение, редактирование одного изображения, слияние нескольких изображений и пакетная генерация последовательностей работают через один /v1/images/generations эндпоинт — отличаются только параметры. APIYI имеет стратегическое партнерство с BytePlus и подключает все активные версии в первый же день.
🎨 Ключевые особенности: три активные версии (5.0 / 4.5 / 4.0) с единой тарификацией + вывод в 4K + до 10 референсных изображений для слияния + пакетная обработка (input + output ≤ 15) + лучшая в классе отрисовка текста. Идеально подходит для главных изображений в e-commerce, рекламных постеров, продуктовой фотографии и создания контента — везде, где важны высокое качество и читаемый текст.
Все API изображений являются синхронными — нет 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 / 4.5 / 4.0, различия в тарификации и руководство по миграции.

Почему Seedream от APIYI

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

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

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

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

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

Та же цена + скидка до 20% за счет пополнений

Базовая цена за единицу совпадает с официальной тарификацией BytePlus. В сочетании с бонусами за пополнение эффективная цена снижается до всего 80% от прайса.

Глобальный доступ без лишних сложностей

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

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

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

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

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

Ключевые возможности

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 и вызывайте через официальный OpenAI SDK. Параметры расширения передаются через extra_body. Для миграции не требуется менять код.

Тарификация

Тарификация за каждое изображение, та же цена, что у официального BytePlus. Бонусы за пополнение дополнительно снижают эффективную цену за единицу.
Примечания по тарификации:
  • Тарификация идет за каждое сгенерированное изображение, независимо от длины prompt или режима fusion
  • seedream-5-0-pro тарифицируется по фиксированной ставке $0.12 за request (1 image на request; пакетная последовательность не поддерживается). Официально модель использует два уровня цен за выходные пиксели (одна цена для ≤2.36M px, одна для >2.36M px) плюс плату за изображение для reference images после первого; APIYI упрощает это до фиксированной цены за request — без уровней, с включенной платой за input-image. У этой модели нет никакой официальной скидки; APIYI устанавливает цену на основе гарантии поставки — фактически без маржи после учета бонусов за пополнение и налоговых расходов — и о любом изменении цены будет объявлено заранее
  • В режиме sequential_image_generation: "auto" тарификация идет по фактическому количеству выходных изображений (например, max_images: 4 outputs 4 → 4 тарифицируется)
  • Неудачные запросы (4xx / заблокированные модерацией) не тарифицируются
  • Бесплатный пробный период: 200 бесплатных изображений при первом onboarding (предоставляется BytePlus)
  • Подробнее о бонусах за пополнение: см. Акции на пополнение

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

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

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

Эндпоинты API

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

Ключевые параметры подробно

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

Две семейства значений — выберите одно: Предустановленные уровни (модель сама выбирает соотношение сторон): Точные пиксели (настраиваемые):
  • Общее число пикселей ∈ [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.19M общих пикселей (максимум 2048×2048; при 16:9 длинная сторона достигает 2720×1530 ≈ 2.7K, проверено как рабочее) — пресетов 3K/4K нет.

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

Эндпоинт /v1/images/generations охватывает и text-to-image, и редактирование/слияние. Два параметра вместе выбирают режим:
seedream-5-0-pro не принимает параметр sequential_image_generation — передача любого значения (включая "disabled") возвращает 400. Для редактирования / слияния с моделью pro указывайте только image и полностью опускайте параметр; то же самое относится к stream.
Полные примеры кода см. в Text-to-Image и Image Editing.

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

1

Выбирайте правильную версию

  • Лучший общий опыт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 — не рекомендуется для повседневного использования)
2

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

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

Явно указывайте изображения

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

Контролируйте стоимость batch-последовательности

sequential_image_generation: "auto" + max_images: 4 дают 4 результата — тарификация × 4. Сначала проверьте с max_images: 1, затем масштабируйте.
5

Выбирайте формат вывода по сценарию использования

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

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

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

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

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

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

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

Частые вопросы

См. Исторические версии для полного сравнения.
Seedream использует единую архитектуру генерации и редактирования — отдельного эндпоинта /v1/images/edits нет. В отличие от gpt-image-2 от OpenAI (multipart upload в /v1/images/edits), Seedream использует application/json и передает image URL изображений в виде массива в поле image.Преимущества: согласованность протокола, повторное использование параметров, простое переключение режимов. Подробности см. в Редактировании изображений.
Да (проверено тестированием). Используйте data URI: data:image/<format>;base64,<base64 string> с <format> в нижнем регистре (например, data:image/jpeg;base64,...). URL и записи base64 можно смешивать в одном массиве. Для больших локальных изображений по-прежнему лучше загрузить их в image host и передать URL, чтобы тело запроса оставалось небольшим.
  • Слияние нескольких изображений (массив image): 4.5 / 5.0-pro явно поддерживают до 10. 5.0 / 4.0 тоже поддерживают работу с несколькими изображениями, хотя явный верхний предел не задокументирован.
  • Пакетная последовательность (max_images): ограничена общим правилом input references + output ≤ 15. При сочетании слияния и последовательности считайте общее количество. Учтите, что 5.0-pro не поддерживает пакетную последовательность (передача sequential_image_generation возвращает 400).
Зависит от 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 и изображений высокого разрешения — frontend может постепенно отображать промежуточные результаты. seedream-5-0-pro не поддерживает потоковую передачу — передача stream возвращает 400.
По умолчанию 500 изображений в минуту (Max Images per Minute), единый для всех версий. Чтобы получить более высокие квоты, свяжитесь с отделом продаж.
Нет. В BytePlus есть встроенная модерация. Отклонения модерации и ошибки параметров возвращают 400 / 403 и не тарифицируются. Другие ошибки без тарификации: 401 (недействительный token), 429 (достигнут лимит запросов). Тарифицируется только успешная генерация (200 с корректным ответом).
Да, без изменений кода. Укажите base_url на https://api.apiyi.com/v1 и передавайте дополнительные параметры (image / sequential_image_generation / watermark и т. д.) через extra_body:
Сгенерированные изображения можно использовать в коммерческих и некоммерческих целях. Подробности см. в условиях обслуживания BytePlus.
seedream-5-0 / seedream-5-0-pro поддерживают вывод png и могут создавать прозрачный фон при соответствующем запросе («прозрачный фон, альфа-канал»). seedream-4-5 / 4-0 выводят только jpeg и не поддерживают прозрачность — удалите фон самостоятельно на этапе постобработки.
Нет. /v1/images/generations выполняется синхронно. После отправки запрос выполняется до завершения. Сервер все равно завершает выполнение и тарифицирует запрос даже если клиент отключится. Настройте тайм-ауты клиента и не рассчитывайте, что отключение сэкономит расходы.

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

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