Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
image_url | Да | Картинка, с которой всё начинается. |
output_format | Нет | Формат файла результата. jpeg · png · По умолчанию: jpeg |
prompt | Нет | Optional: name the elements to separate. Leave empty to let the model pick the main elements. |
resolution | Нет | Размер результата. Больше — чётче и дороже. auto · 1k · 1.5k · 2k · По умолчанию: 1.5k |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| resolution 1.5K | 6,3 | 0,063 $ |
| resolution 1K | 6,3 | 0,063 $ |
| resolution 2K | 12,6 | 0,13 $ |
| resolution auto | 12,6 | 0,13 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 7 кредитов за изображение (0,07 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Seedream 5.0 Pro в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seedream-5.0-pro/layer-decomposition и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
- Получите результат. Опрашивайте GET /jobs/recordInfo по ID задачи или передайте callBackUrl — мы отправим результат туда. Когда задача выполнится, скачайте файлы по ссылкам.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"resolution": "1.5k",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Замените промпт и ссылки на свои. Справка по ответу, опросу статуса и callback есть на вкладке API.
Вопросы об API Seedream 5.0 Pro
Сколько стоит API Seedream 5.0 Pro?
Seedream 5.0 Pro стоит от 7 кредитов (0,07 $) за изображение — на самой дешёвой задаче «Разделение на слои». Цены по вариантам: 1.5K 6,3 кредита за изображение, 1K 6,3 кредита за изображение, 2K 12,6 кредита за изображение, auto 12,6 кредита за изображение. Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Seedream 5.0 Pro в API?
Укажите bytedance/seedream-5.0-pro/text-to-image — Создать картинку; bytedance/seedream-5.0-pro/edit — Редактировать картинку; bytedance/seedream-5.0-pro/layer-decomposition — Разделение на слои в поле model запроса POST /jobs/createTask.
Сколько референсов принимает одна правка?
До десяти. Раздайте каждому роль в prompt, потому что безымянные источники сливаются. Каждый референс после первого добавляется к оценке, которую вы видите до отправки.
Можно задать размер или соотношение сторон результата?
Да, но через соотношение и ступень, а не через произвольные пиксели. aspect_ratio принимает пятнадцать форм от 1:3 до 3:1, resolution выбирает 1k или 2k. У text-to-image по умолчанию 1:1, у редактуры — auto: поддерживаемое соотношение, ближайшее к первому референсу. Если нужен именованный пресет ширина*высота, берите Seedream 5.0 Lite.
Есть ли seed для воспроизводимых результатов?
Нет. Ни один из эндпоинтов его не открывает, поэтому два одинаковых запроса вернут два разных кадра. Храните prompt рядом с любым файлом, который планируете переиспользовать.
JPEG или PNG — что запрашивать?
png, когда кадр идёт в ретушь или композитинг и важны края без потерь; jpeg — под циклы согласования и прямую поставку. Меняется получаемый файл, а не сгенерированное изображение.
Умеет ли он рисовать текст внутри изображения?
Короткие строки иногда получаются, но модель не для этого. Для вывесок, заголовков и надписей на упаковке берите модель, сделанную под внутрикадровую типографику.
Какие ограничения у API Seedream 5.0 Pro?
Разрешения: auto · 1K · 1.5K · 2K; Длина промпта (символов): 5,000; Максимальный размер загрузки: 30 MB. Запросы за пределами этих ограничений отклоняются до любого списания.
Можно попробовать Seedream 5.0 Pro без кода?
Да. Playground запускает Seedream 5.0 Pro на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Seedream
Seedream 5.0 Lite работает с фиксированными размерами кадра 2K, и серия получается единой, а Seedream 5.0 Flash — быстрый и более дешёвый собрат. Pro нужен для финального, самого детального кадра.
- Seedream 5.0 Pro APIДетальные картинки и правки по десяти референсамОт 6 кредитов за изображение
- Seedream 5.0 Flash APIБыстрый Seedream: картинки, правки и слои до 2KОт 4 кредитов за изображение
- Seedream 5.0 Lite APIКадры 2K фиксированного размера для единой серииОт 6 кредитов за изображение
- Seedream 4.0 APIТочные размеры до 4096×2304 и правки по десяти референсамОт 5 кредитов за изображение

