Seedream 5.0 Pro

Seedream 5.0 Pro (bytedance-seed/seedream-5-0-pro) — старшая версия Seedream от ByteDance для генерации и редактирования картинок: точный контроль правок, живые сцены и естественный рендер — под коммерческую продакшн-графику. Два эндпоинта: POST /v1/images/generations для генерации по тексту и POST /v1/images/edits для работы по картинке-образцу. Модель платная — генерации списываются с баланса.

Параметры

Поле	Описание
`model`	`bytedance-seed/seedream-5-0-pro` (или короткое `seedream-5-0-pro`)
`prompt`	Описание изображения, обязательное
`n`	Сколько картинок, от 1 до 4; каждая тарифицируется отдельно
`aspect_ratio`	`1:1`, `1:2`, `2:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `9:21`, `16:9`, `21:9`; по умолчанию `1:1`
`resolution`	`1k` или `2k`; по умолчанию `1k`
`size`	Явный размер `WxH` — альтернатива паре `aspect_ratio` + `resolution`
`quality`	У модели нет такой ручки: передача параметра вернёт `400`

Правила размера различаются по разрешению: 1k держит площадь около мегапикселя, а 2k упирает длинную сторону в 2048. Ходовые комбинации:

Формат	1k	2k
`1:1`	`1000x1000`	`2048x2048`
`16:9`	`1332x750`	`2048x1152`
`9:16`	`750x1332`	`1152x2048`
`21:9`	`1526x654`	`2048x876`
`2:1`	`1414x706`	`2048x1024`

Первичный контракт модели — пара «формат + разрешение»: size принимается по той же таблице и обратно мапится в неё. Полный список из 26 допустимых size — поле sizes в каталоге; значение вне списка вернёт 400.

Примеры

import base64

img = client.images.generate(
    model="bytedance-seed/seedream-5-0-pro",
    prompt="Коммерческий кадр для каталога: флакон парфюма на мокром камне, капли, утренний свет",
    extra_body={"aspect_ratio": "4:5", "resolution": "1k"},
)
with open("perfume.png", "wb") as f:
    f.write(base64.b64decode(img.data[0].b64_json))

curl https://api.mixen.ai/v1/images/generations \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance-seed/seedream-5-0-pro",
    "prompt": "Коммерческий кадр для каталога: флакон парфюма на мокром камне, капли, утренний свет",
    "aspect_ratio": "4:5",
    "resolution": "1k"
  }'

Вертикальная обложка в 2k

{
  "model": "bytedance-seed/seedream-5-0-pro",
  "prompt": "Обложка журнала о путешествиях: одинокая фигура на дюне на рассвете",
  "aspect_ratio": "9:16",
  "resolution": "2k"
}

Составная правка по двум образцам

Модель принимает картинки-образцы (references: true), поэтому доступен /v1/images/edits с multipart/form-data — до 5 референсов:

curl https://api.mixen.ai/v1/images/edits \
  -H "Authorization: Bearer $MIXEN_API_KEY" \
  -F model=bytedance-seed/seedream-5-0-pro \
  -F image=@product.png \
  -F image=@marble.png \
  -F prompt="Перенеси флакон на эту мраморную поверхность, добавь мягкое отражение"

Ответ всегда содержит b64_json — файлы не хостятся. Оба эндпоинта отвечают синхронно; ставьте таймаут HTTP-клиента не меньше 120 секунд.

Цена

Цена зависит от разрешения — 2k ровно вдвое дороже 1k:

Разрешение	Цена за изображение
`1k`	6.0162 ₽ ($0.0675)
`2k`	12.0324 ₽ ($0.135)

Актуальные значения — каталог.

Сильные стороны и ограничения

Точный контроль правок, живые сцены и естественный рендер — под коммерческую продакшн-графику.
Тринадцать форматов кадра, включая ультра-широкие 21:9 и 9:21.
До 5 картинок-образцов в /v1/images/edits — составные правки из нескольких референсов.
Крупный формат стоит дороже: 2k вдвое дороже 1k — планируйте разрешение в бюджет.
Seedream 5.0 Lite (bytedance-seed/seedream-5-0-lite) — легче и дешевле: 4.6793 ₽ ($0.0525), разрешения 2k/4k без 1k, те же форматы и референсы.
Работает только с баланса; ручки quality нет — размер вне таблицы модели вернёт 400.

Все модели — в каталоге. Общий порядок работы с изображениями — гайд по изображениям.