Seedream API

Кроме браузерной площадки у Seedream есть второй вход — прямое обращение к модели из своего кода. Ссылка «Get API» стоит на странице модели, а сам доступ выдают два облака ByteDance: Volcano Engine для Китая и BytePlus для остальных команд.

012входа к одной модели// два облака

Одна модель,
две точки входа

Volcano Engine — облако ByteDance для внутреннего рынка. Модель подключается к вашему коду и оплачивается по факту обращений: платите за то, что реально сгенерировали, а не за окно доступа.

BytePlus — международное подразделение того же облака. Набор моделей Seed там тот же, отличается юридическое лицо, регион размещения и язык консоли. Командам вне Китая заводить доступ проще здесь.

Обе консоли работают с каталогом Seed целиком, а не только с Seedream: рядом лежат Seedance для видео, SeedEdit 3.0 для правки фотографий и звуковые модели. Один ключ открывает то, что вы подключили в своём проекте.

Китай

Volcano Engine

Облако ByteDance. Доступ к модели из своего кода, оплата по факту обращений.

Открыть консоль

остальной мир

BytePlus

То же облако для зарубежных команд — тот же доступ к моделям Seed.

Открыть консоль

024шага до первого кадра// порядок подключения

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

шаг 1

Аккаунт в облаке

Регистрация в Volcano Engine или BytePlus — выбор зависит от того, где находится команда и на какое лицо оформляется договор.

шаг 2

Подключение модели

В консоли Seedream включается отдельно, как и любая другая модель каталога Seed. До включения обращения к ней не проходят.

шаг 3

Ключ доступа

Секрет выдаётся один раз и хранится вне репозитория. Ключ привязан к проекту, а не к человеку.

шаг 4

Первое обращение

Запрос уходит с текстом промпта и параметрами кадра, ответ приходит готовым изображением. Дальше это обычный HTTP-вызов в вашем коде.

03// чем отличается от браузера

Площадка и API рядом

Модель за обоими входами одна, отличается способ обращения к ней и то, кто держит результат.

Что сравниваем Dreamina в браузере Обращение по API
Как задаётся запрос Руками в поле ввода Параметром в теле запроса
Сколько кадров за раз По одному, с просмотром глазами Пакетом, циклом в коде
Куда попадает результат В галерею аккаунта на площадке В ваш обработчик ответа
Как считается оплата Внутренними кредитами площадки По факту обращений к модели
Что нужно уметь Ничего сверх работы в браузере Отправлять HTTP-запрос и разбирать ответ
Правка готового кадра Пометками и набросками мышью Отдельным вызовом с исходным изображением
04// на чём это окупается

Где API выигрывает у окна браузера

Пакетный ввод-вывод заявлен у Seedream 4.0 как отдельная возможность, и через код он раскрывается полностью: карточки товара всей номенклатурой, обложки под каталог статей, серия иллюстраций в одном стиле — за один прогон.

Второе — встраивание в чужой интерфейс. Генерация уезжает внутрь вашего продукта: пользователь нажимает кнопку у себя, а Seedream отвечает на стороне сервера, не показываясь наружу.

Цен ByteDance не публикует ни на странице модели, ни в каталоге Seed — тариф на обращение виден в самой консоли облака после подключения модели.

Seedream — карточка товара, сгенерированная через API
карточка товара · 9:16
05// что приходит в ответ

Кадр как ответ на запрос

Через код у модели те же возможности, что и через окно площадки: пропорции, разрешение, работа с текстом внутри кадра. Меняется только то, что параметры приходят полями запроса, а изображение возвращается в ответе.

Seedream — ночная городская сцена, полученная обращением к модели из кода
ответ модели · 1:1
Seedream — студийный портрет из пакетной генерации
портрет из пакета · 4:5
Seedream — квадратная схема, собранная одним вызовом
схема из серии · 1:1

Каталог Seed открывается тем же ключом целиком, поэтому связка получается естественной: Seedream рисует обложку, Seedance превращает её в ролик, Seed Audio подкладывает звук. Три обращения из одного проекта, без переноса файлов между площадками руками.

Сначала проверить модель, потом писать код

Прогоните свой промпт через площадку в браузере — станет видно, ту ли картинку модель даёт, до того как заводить ключ и обвязку.

Дальше по теме