Обзор
Seedream — флагманская серия моделей генерации изображений от ByteDance BytePlus ModelArk, с единой архитектурой генерации и редактирования: преобразование текста в изображение, редактирование одного изображения, слияние нескольких изображений и пакетная генерация последовательностей работают через один/v1/images/generations эндпоинт — отличаются только параметры. APIYI имеет стратегическое партнерство с BytePlus и подключает все активные версии в первый же день.
API преобразования текста в изображение
POST /v1/images/generations. Генерируйте изображения по prompt в 1K / 2K / 3K / 4K или с точными размерами в пикселях.API редактирования изображений
image. Редактирование одного изображения, слияние нескольких изображений и пакетная последовательность (до 15 изображений).Исторические версии
Почему Seedream от APIYI
Полная замена официального канала BytePlus ModelArk, оптимизированная для production по трем направлениям — стабильность, стоимость, интеграция:Стратегическое партнерство · стабильные ресурсы
Неограниченные параллельные запросы · корпоративного уровня
Та же цена + скидка до 20% за счет пополнений
Глобальный доступ без лишних сложностей
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
Ключевые возможности
4K-вывод с высокой детализацией
Единая генерация и редактирование
image и sequential_image_generation.Слияние нескольких изображений · до 10 референсов
image принимает массив URL. Указывайте в prompt «изображение 1 / изображение 2» для явного порядка. Используйте вместе с sequential_image_generation: "disabled" для согласованного сохранения объекта.Прорыв в рендеринге текста
Пакетная последовательность (до 15)
sequential_image_generation: "auto" вместе с max_images выдает согласованную серию — идеально для раскадровок, брендовых визуалов и серий продуктов.≈ 15 с на изображение · сбалансированная скорость
Гибкие размеры · произвольные пропорции
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: 4outputs 4 → 4 тарифицируется) - Неудачные запросы (4xx / заблокированные модерацией) не тарифицируются
- Бесплатный пробный период: 200 бесплатных изображений при первом onboarding (предоставляется BytePlus)
- Подробнее о бонусах за пополнение: см. Акции на пополнение
Технические характеристики
Сравнение времени генерации
Измеренная задержка одного запроса по версии (измерено 2026-07, UTC+8; время по часам от запроса до полного ответа — ожидайте обычные колебания между запросами):Эндпоинты API
Ключевые параметры подробно
size (размер вывода)
Две семейства значений — выберите одно:
Предустановленные уровни (модель сама выбирает соотношение сторон):
- Общее число пикселей ∈ [1280×720, 4096×4096]
- Соотношение сторон ∈ [1/16, 16]
- По умолчанию:
2048x2048
1920x1080 (FullHD), 3840x2160 (ландшафтный 4K), 1080x1920 (портретный режим телефона), 2560x1440 (ландшафтный 2K)
Недопустимые примеры: 5000x5000 (превышает лимит), 100x1600 (соотношение сторон меньше 1/16)
image и sequential_image_generation (переключатели режима)
Эндпоинт /v1/images/generations охватывает и text-to-image, и редактирование/слияние. Два параметра вместе выбирают режим:
Лучшие практики
Выбирайте правильную версию
- Лучший общий опыт →
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» — вместо того чтобы заставлять модель гадать.Контролируйте стоимость batch-последовательности
sequential_image_generation: "auto" + max_images: 4 дают 4 результата — тарификация × 4. Сначала проверьте с max_images: 1, затем масштабируйте.Выбирайте формат вывода по сценарию использования
png и jpeg; 4.5 / 4.0 — только jpeg. Используйте серию 5.0 + png, когда нужны прозрачные фоны или без потерь деталей, jpeg — для сценариев, чувствительных к размеру.Установите тайм-аут клиента ≥ 60 секунд
seedream-5-0-pro занимает ~2 минуты на изображение — используйте тайм-аут 240 с или больше.Отключайте водяной знак при необходимости
watermark: false, чтобы удалить водяной знак BytePlus (значения по умолчанию зависят от версии, поэтому задавайте его явно). Требуется для коммерческих материалов.Коды ошибок и повторные попытки
- Начните с таймаута запроса 60 секунд (batch sequence или 4K + hd могут занимать до минуты)
- Применяйте экспоненциальную задержку для 5xx и таймаутов (рекомендуется 2 повторные попытки)
- Логируйте заголовок ответа
x-request-idдля обращений в поддержку
Частые вопросы
5.0 Pro / 5.0 / 4.5 / 4.0 — что выбрать?
5.0 Pro / 5.0 / 4.5 / 4.0 — что выбрать?
Почему редактирование изображений тоже использует эндпоинт генерации?
Почему редактирование изображений тоже использует эндпоинт генерации?
/v1/images/edits нет. В отличие от gpt-image-2 от OpenAI (multipart upload в /v1/images/edits), Seedream использует application/json и передает image URL изображений в виде массива в поле image.Преимущества: согласованность протокола, повторное использование параметров, простое переключение режимов. Подробности см. в Редактировании изображений.Поле image принимает base64?
Поле image принимает base64?
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).
Требуется ли у b64_json префикс data:image?
Требуется ли у b64_json префикс data:image?
response_format:response_format: "url"(по умолчанию) →data[0].url— это временный подписанный URL, рендерите напрямую с помощью<img src=...>response_format: "b64_json"→data[0].b64_json— это обычная base64-строка (без префиксаdata:image/...;base64,). Декодируйте и запишите на диск либо вручную добавьте префикс для отображения в браузере.
Поддерживается ли потоковая передача вывода?
Поддерживается ли потоковая передача вывода?
stream: true. Потоковая передача особенно полезна для длинных prompt и изображений высокого разрешения — frontend может постепенно отображать промежуточные результаты. seedream-5-0-pro не поддерживает потоковую передачу — передача stream возвращает 400.Лимит запросов?
Лимит запросов?
Тарифицируются ли неудачные запросы?
Тарифицируются ли неудачные запросы?
400 / 403 и не тарифицируются. Другие ошибки без тарификации: 401 (недействительный token), 429 (достигнут лимит запросов). Тарифицируется только успешная генерация (200 с корректным ответом).Можно ли использовать официальный OpenAI SDK?
Можно ли использовать официальный OpenAI SDK?
base_url на https://api.apiyi.com/v1 и передавайте дополнительные параметры (image / sequential_image_generation / watermark и т. д.) через extra_body:Кому принадлежат сгенерированные изображения?
Кому принадлежат сгенерированные изображения?
Поддерживаются ли прозрачные фоны?
Поддерживаются ли прозрачные фоны?
seedream-5-0 / seedream-5-0-pro поддерживают вывод png и могут создавать прозрачный фон при соответствующем запросе («прозрачный фон, альфа-канал»). seedream-4-5 / 4-0 выводят только jpeg и не поддерживают прозрачность — удалите фон самостоятельно на этапе постобработки.Можно ли отменить генерацию в процессе?
Можно ли отменить генерацию в процессе?
/v1/images/generations выполняется синхронно. После отправки запрос выполняется до завершения. Сервер все равно завершает выполнение и тарифицирует запрос даже если клиент отключится. Настройте тайм-ауты клиента и не рассчитывайте, что отключение сэкономит расходы.Связанные документы
- Песочница Text-to-Image —
POST /v1/images/generationsс пятью примерами кода на разных языках - Песочница редактирования изображений — шаблоны
image+sequential_image_generation - Исторические версии — сравнение 5.0 / 4.5 / 4.0 и миграция
- Руководство по API — общее руководство по вызовам
- Песочница генерации изображений — попробуйте онлайн
- Официальная документация BytePlus:
docs.byteplus.com/en/docs/ModelArk/1824121— учебник Seedream 4.0-5.0