Пока это руководство есть только на английском. →
Параметры запроса
| Параметр | Обязательный | Описание |
|---|---|---|
size | Нет | Output image size in pixels, written as width*height. 2048*2048 · 1024*1024 · 2304*1728 · 1728*2304 · 2848*1600 · 1600*2848 · 2496*1664 · 1664*2496 · 3136*1344 · 3072*3072 · 3456*2592 · 2592*3456 · 4096*2304 · 2304*4096 · 2496*3744 · 3744*2496 · По умолчанию: 2048*2048 |
prompt | Да | Describe the image to generate: subject, composition, style, and lighting. |
Цены
Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.
| Вариант | Кредиты за изображение | ≈ USD |
|---|---|---|
| Стандарт | 4,5 | 0,045 $ |
Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 5 кредитов за изображение (0,05 $).
Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.
Быстрый старт API
Вызов API Seedream 4.0 в три шага
- Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
- Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seedream-4.0/text-to-image и объектом 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-4.0/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"size": "2048*2048"
}
}'
# 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 4.0
Сколько стоит API Seedream 4.0?
Seedream 4.0 стоит от 5 кредитов (0,05 $) за изображение — на самой дешёвой задаче «Создать картинку». Кредиты те же, что и на сайте (1 кредит = 0,01 $), новые аккаунты получают 30 бесплатных кредитов, а за неудачные задачи кредиты возвращаются.
Какое имя модели у Seedream 4.0 в API?
Укажите bytedance/seedream-4.0/text-to-image — Создать картинку; bytedance/seedream-4.0/edit — Редактировать картинку в поле model запроса POST /jobs/createTask.
Чем Seedream 4.0 отличается от 5.0 Lite?
4.0 — предыдущее поколение. В 5.0 Lite есть выбор jpeg или png, но пресетов всего восемь, и все на ступени 2K; 4.0 сохраняет шестнадцать пресетов от квадрата 1024*1024 до 4096*2304 и собственную манеру отрисовки. Выбирайте 4.0, когда нужны более крупные кадры или нужно совпасть с работой, уже сделанной на ней.
Сколько референсов принимает редактирование?
До десяти. Назовите роль каждого в промпте — референсы без роли смешиваются — и помните, что size применяется и к результату.
Есть ли seed для воспроизводимых результатов?
Нет. Ни один эндпоинт его не предоставляет, поэтому одинаковые запросы дают разные кадры. Храните промпт вместе с каждым изображением, которое планируете использовать повторно.
Можно ли выбрать JPEG или PNG?
Нет. У этой модели нет поля формата файла, изображение приходит в том формате, который отдаёт модель. Если пайплайну нужен конкретный формат, конвертируйте после получения.
Можно попробовать Seedream 4.0 без кода?
Да. Playground запускает Seedream 4.0 на ваших кредитах PopNow без API-ключа и показывает код для каждой генерации.
Все модели Seedream
Seedream 5.0 Pro и Lite — новое поколение с более тонкой детализацией материалов; у 4.0 свой облик и самые большие размеры.
- 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 кредитов за изображение

