> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Генерация и редактирование изображений Seedream
> Полное руководство по моделям генерации изображений ByteDance BytePlus ModelArk Seedream — три активные версии (5.0 / 4.5 / 4.0), вывод 4K, объединение нескольких изображений, пакетная генерация последовательностей, редактирование по эталонному изображению — все на одном endpoint.
## Обзор
**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 изображений](/ru/api-capabilities/image-api-best-practices).
**Какая это версия Seedream?** APIYI предоставляет Seedream на **официальных зарубежных ресурсах BytePlus (международная версия)** — а не на материковой редакции Doubao / Volcengine. Международная версия применяет сравнительно более мягкую политику модерации контента, чем внутренняя, давая вам больше творческой свободы — это реальное преимущество этой платформы, но **это не означает отсутствие модерации**: BytePlus по-прежнему выполняет встроенные проверки безопасности контента, а нарушающие правила prompt'ы или референсные изображения отклоняются с 400/403 (отклонения не тарифицируются). Используйте в рамках требований.
`POST /v1/images/generations`. Генерируйте изображения по prompt в 1K / 2K / 3K / 4K или с точными размерами в пикселях.
Тот же эндпоинт с параметром `image`. Редактирование одного изображения, слияние нескольких изображений и пакетная последовательность (до 15 изображений).
Сравнение спецификаций 5.0 / 4.5 / 4.0, различия в тарификации и руководство по миграции.
## Почему Seedream от APIYI
Полная замена официального канала BytePlus ModelArk, оптимизированная для production по трем направлениям — **стабильность**, **стоимость**, **интеграция**:
Авторизованное прямое подключение к BytePlus ModelArk. Поведение запросов и ответов идентично upstream — **без обхода протокола**, безопасно для production.
Линейное масштабирование для пакетной генерации, слияния нескольких изображений и последовательной генерации — без ограничений аккаунта в стиле Tier. **По умолчанию 500 RPM**, для более высоких квот свяжитесь с отделом продаж.
Базовая цена за единицу совпадает с официальной тарификацией BytePlus. В сочетании с [бонусами за пополнение](/ru/faq/recharge-promotions) эффективная цена снижается до **всего 80%** от прайса.
**Не требуется зарубежный сервер или proxy**. Подключается напрямую к `api.apiyi.com` из дата-центров материкового Китая, домашних сетей и зарубежных узлов. Не нужно настраивать маршрутизацию для регионов BytePlus `ap-southeast-1` / `eu-west-1`.
Путь `/v1/images/generations` идентичен OpenAI. Укажите в OpenAI SDK `base_url` APIYI и вызывайте API без изменений. Передавайте дополнительные параметры (`image` / `sequential_image_generation` и т. д.) через `extra_body`. Обратите внимание: параметр `n` в OpenAI upstream не поддерживается (игнорируется без предупреждения — вы все равно получите 1 image); используйте `sequential_image_generation` для вывода нескольких изображений.
Глубокая экспертиза в сценариях генерации изображений — слияние нескольких изображений, рендеринг текста, пакетное производство ассетов. Сквозная поддержка от PoC до запуска в production.
## Ключевые возможности
4.0 / 4.5 поддерживают нативный 4K (4096×4096) с богатыми слоями детализации — идеально для постеров и печатной продукции. 5.0-lite ограничивается 3K, но обеспечивает более отточенный общий опыт.
текст-в-изображение, редактирование одного изображения, слияние нескольких изображений и пакетная последовательность используют **один эндпоинт и один набор параметров**. Переключайте режимы через `image` и `sequential_image_generation`.
`image` принимает массив URL. Указывайте в prompt «изображение 1 / изображение 2» для явного порядка. Используйте вместе с `sequential_image_generation: "disabled"` для согласованного сохранения объекта.
В версии 4.5 значительно улучшена читаемость мелкого текста. Постеры, рекламные тексты и текст на товарах получаются четкими и точными — лучшее в своем классе.
`sequential_image_generation: "auto"` вместе с `max_images` выдает согласованную серию — идеально для раскадровок, брендовых визуалов и серий продуктов.
Типичная задержка для одного изображения составляет \~15 с; 4K + hd может увеличить ее до минуты. **500 RPM** по умолчанию, масштабируется по запросу.
Пресеты разрешения (`1K`/`2K`/`3K`/`4K`) или точные пиксели. Общее число пикселей ∈ \[1280×720, 4096×4096], соотношение сторон ∈ \[1/16, 16].
Задайте `base_url=https://api.apiyi.com/v1` и вызывайте через официальный OpenAI SDK. Параметры расширения передаются через `extra_body`. Для миграции не требуется менять код.
## Тарификация
Тарификация за каждое изображение, **та же цена, что у официального BytePlus**. Бонусы за пополнение дополнительно снижают эффективную цену за единицу.
| Model | Цена APIYI | Розничная цена (RMB, оцен.) | Статус |
| ------------------------- | -------------------------- | --------------------------- | --------------------------------------------------------------- |
| `seedream-5-0-pro-260628` | \$0.12 / request (1 image) | ≈ ¥0.84 / request | 🆕 Pro tier (\~2 min per image; use 5.0-lite for everyday work) |
| `seedream-5-0-260128` | \$0.035 / image | ≈ ¥0.245 / image | ✅ Рекомендуется (последняя версия) |
| `seedream-4-5-251128` | \$0.04 / image | ≈ ¥0.28 / image | ✅ Рекомендуется |
| `seedream-4-0-250828` | \$0.03 / image | ≈ ¥0.21 / image | 🟡 Поддерживается (по-прежнему доступна для вызова) |
**Примечания по тарификации**:
* Тарификация идет за каждое сгенерированное изображение, независимо от длины 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)
* Подробнее о бонусах за пополнение: см. [Акции на пополнение](/ru/faq/recharge-promotions)
## Технические характеристики
| Параметр | seedream-5-0-pro | seedream-5-0 | seedream-4-5 | seedream-4-0 |
| ------------------------------------- | ---------------------------------------------------------------------------------------------- | --------------------------------- | --------------------- | --------------------- |
| **ID модели** | `seedream-5-0-pro-260628` | `seedream-5-0-260128` | `seedream-4-5-251128` | `seedream-4-0-250828` |
| **Псевдоним ID модели** | — | `seedream-5-0-lite-260128` | — | — |
| **Дата выпуска** | 2026-06-28 (UTC+8) | 2026-01-28 (UTC+8) | 2025-11-28 (UTC+8) | 2025-08-28 (UTC+8) |
| **Уровни разрешения** | 1K / 2K + точное WxH (≤ 4.19M всего px; при 16:9 самая длинная сторона достигает 2720, \~2.7K) | 2K / 3K | 2K / 4K | 1K / 2K / 4K |
| **Формат вывода** | `png` / `jpeg` | `png` / `jpeg` | `jpeg` | `jpeg` |
| **Оптимизация prompt** | standard / fast | standard | standard | standard / fast |
| **Text-to-image** | ✅ | ✅ | ✅ | ✅ |
| **Редактирование одного изображения** | ✅ | ✅ | ✅ | ✅ |
| **Слияние нескольких изображений** | ✅ (до 10) | ✅ | ✅ (до 10) | ✅ |
| **Пакетная последовательность** | ❌ (400, если передано) | ✅ | ✅ | ✅ |
| **Потоковый вывод** | ❌ (400, если передано) | ✅ | ✅ | ✅ |
| **Макс. изображений в минуту (RPM)** | 500 | 500 | 500 | 500 |
| **Вход + выход одного запроса** | input ≤ 10, output 1 | ≤ 15 | ≤ 15 | ≤ 15 |
| **Типичная задержка** | \~2 minutes | \~30s | 10-20s | 10-15s |
| **Поле ответа** | то же самое | `data[].url` or `data[].b64_json` | то же самое | то же самое |
## Сравнение времени генерации
Измеренная задержка одного запроса по версии (измерено 2026-07, UTC+8; время по часам от запроса до полного ответа — ожидайте обычные колебания между запросами):
| Сценарий | seedream-4-0 | seedream-4-5 | seedream-5-0 | seedream-5-0-pro |
| ------------------------------------------------------------------ | ------------ | ------------ | ------------ | ------------------------------------ |
| Текст-в-изображение (1K/2K) | 7-11s | 8-13s | 29-34s | **110-130s** |
| Текст-в-изображение (высший уровень) | \~15s (4K) | \~18s (4K) | \~37s (3K) | \~134s (W×H 2720×1530, макс. размер) |
| Редактирование / слияние нескольких изображений | \~11s | 17-21s | 38-40s | **115-132s** |
| Пакетная последовательность (2 изображения, редактирование + авто) | — | \~36s | — | — (не поддерживается) |
| **Рекомендуемый тайм-аут клиента** | ≥ 60s | ≥ 60s | ≥ 120s | **≥ 240s** |
**`seedream-5-0-pro`** стабильно занимает около 2 минут на изображение (110-132s измерено в каждом запуске, без исключений). Это ожидаемое поведение для модели изображений с глубоким рассуждением, а не сбой. Перед тем как выбирать pro, убедитесь, что ваш продукт может выдержать такую задержку: интерактивные сценарии (когда пользователь ждёт на экране) подходят плохо — вместо этого используйте 5.0-lite (\~30s); pro лучше подходит для офлайн-пакетной обработки, где важнее всего качество изображений и соблюдение инструкций.
## Эндпоинты API
| Эндпоинт | Назначение | Content-Type |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `POST /v1/images/generations` | Генерация изображений по тексту / редактирование одного изображения / слияние нескольких изображений / пакетная последовательность — все режимы используют **один эндпоинт**, переключение выполняется через параметры тела запроса | `application/json` |
**Выбор домена**: `api.apiyi.com` — основной эндпоинт. `vip.apiyi.com` и другие домены шлюза тоже доступны, поведение идентично. **Вам не нужно использовать** собственные домены BytePlus, такие как `ark.ap-southeast.bytepluses.com` / `ark.eu-west.bytepluses.com`, — APIYI нормализует все в пути, совместимые с OpenAI.
## Ключевые параметры подробно
### `size` (размер вывода)
Две семейства значений — выберите одно:
**Предустановленные уровни** (модель сама выбирает соотношение сторон):
| Уровень | Примерное число пикселей | Поддерживается в |
| ------- | -------------------------- | ---------------- |
| `1K` | \~1024×1024 | 4.0 / 5.0-pro |
| `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.19M общих пикселей (максимум 2048×2048; при 16:9 длинная сторона достигает 2720×1530 ≈ 2.7K, проверено как рабочее) — пресетов 3K/4K нет**.
### `image` и `sequential_image_generation` (переключатели режима)
Эндпоинт `/v1/images/generations` охватывает и text-to-image, и редактирование/слияние. Два параметра вместе выбирают режим:
| Режим | `image` | `sequential_image_generation` | Примечания |
| ------------------------------------ | ----------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------ |
| Чистый text-to-image | не указан | не указан или `"disabled"` | 1 результат |
| Редактирование по одному изображению | `["url1"]` | `"disabled"` | Редактирование на основе 1 эталона |
| Слияние нескольких изображений | `["url1", "url2", ...]` | `"disabled"` | До 10 эталонов; ссылайтесь как на «изображение 1 / изображение 2» |
| Пакетная последовательность | необязательно | `"auto"` + `sequential_image_generation_options.max_images` | N согласованных результатов, **N ≤ max\_images** и **вход + выход ≤ 15** |
**`seedream-5-0-pro` не принимает параметр `sequential_image_generation`** — передача любого значения (включая `"disabled"`) возвращает 400. Для редактирования / слияния с моделью pro указывайте только `image` и полностью опускайте параметр; то же самое относится к `stream`.
Полные примеры кода см. в [Text-to-Image](/ru/api-capabilities/seedream-image/text-to-image) и [Image Editing](/ru/api-capabilities/seedream-image/image-edit).
## Лучшие практики
* **Лучший общий опыт** → `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 для стабильной скорости и качества. Используйте точные пиксели только когда у вас есть реальное требование к соотношению сторон. Учитывайте различия между версиями в поддерживаемых уровнях.
При наличии нескольких `image` URLs пишите prompt с явными ссылками — «Поместите человека из изображения 1 в сцену изображения 2, используя цветовую палитру изображения 3» — вместо того чтобы заставлять модель гадать.
`sequential_image_generation: "auto"` + `max_images: 4` дают 4 результата — тарификация × 4. Сначала проверьте с `max_images: 1`, затем масштабируйте.
5.0 / 5.0-pro поддерживают `png` и `jpeg`; 4.5 / 4.0 — только `jpeg`. Используйте серию 5.0 + png, когда нужны прозрачные фоны или без потерь деталей, jpeg — для сценариев, чувствительных к размеру.
Одно изображение занимает \~15 с, но batch-последовательность (4 изображения) или 4K + hd могут занять 30-60 с. **Начните с тайм-аута клиента 60 с** и показывайте в UI индикатор прогресса. **`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` для обращений в поддержку
## Частые вопросы
| Нужно | Рекомендуется |
| -------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| Новейшие функции + лучший вариант в целом | `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 мин на изображение — пропустите, если это вам не нужно) |
См. [Исторические версии](/ru/api-capabilities/seedream-image/historical-versions) для полного сравнения.
Seedream использует единую архитектуру генерации и редактирования — **отдельного эндпоинта `/v1/images/edits` нет**. В отличие от gpt-image-2 от OpenAI (multipart upload в `/v1/images/edits`), Seedream использует `application/json` и передает image **URL изображений в виде массива** в поле `image`.
Преимущества: согласованность протокола, повторное использование параметров, простое переключение режимов. Подробности см. в [Редактировании изображений](/ru/api-capabilities/seedream-image/image-edit).
**Да** (проверено тестированием). Используйте data URI: `data:image/;base64,` с `` в нижнем регистре (например, `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, рендерите напрямую с помощью `
`
* `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`:
```python theme={null}
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` и могут создавать прозрачный фон при соответствующем запросе («прозрачный фон, альфа-канал»). `seedream-4-5` / `4-0` выводят только `jpeg` и **не поддерживают прозрачность** — удалите фон самостоятельно на этапе постобработки.
**Нет**. `/v1/images/generations` выполняется синхронно. После отправки запрос выполняется до завершения. Сервер все равно завершает выполнение и тарифицирует запрос даже если клиент отключится. Настройте тайм-ауты клиента и не рассчитывайте, что отключение сэкономит расходы.
## Связанные документы
* [Песочница Text-to-Image](/ru/api-capabilities/seedream-image/text-to-image) — `POST /v1/images/generations` с пятью примерами кода на разных языках
* [Песочница редактирования изображений](/ru/api-capabilities/seedream-image/image-edit) — шаблоны `image` + `sequential_image_generation`
* [Исторические версии](/ru/api-capabilities/seedream-image/historical-versions) — сравнение 5.0 / 4.5 / 4.0 и миграция
* [Руководство по API](/ru/api-manual) — общее руководство по вызовам
* [Песочница генерации изображений](https://imagen.apiyi.com/) — попробуйте онлайн
* Официальная документация BytePlus: `docs.byteplus.com/en/docs/ModelArk/1824121` — учебник Seedream 4.0-5.0
Seedream предоставляется через стратегическое партнерство APIYI с BytePlus ModelArk. Три версии используют единые пути интеграции, тарификации и аутентификации — выбирайте по потребностям. По вопросам или отзывам создайте тикет из консоли.