PopNowДокументация API
Основное содержимое

Seedream 4.0: справочник по API

Точные размеры до 4096×2304 и правки по десяти референсам

С одним ключом PopNow API вы вызываете Seedream 4.0 прямо из своего кода. Здесь собраны ID модели, которые нужно передать, все поля, которые она принимает, стоимость запроса в кредитах и готовый запрос — его можно вставить в терминал и запустить.

Описания параметров взяты из входной схемы модели и пока доступны только на английском.

Кратко

Разработчик
ByteDance
Результат
Изображение
От
4.5 кр. за изображение ($0.045)
Обычное время
около 20 с

1 кредит = 0,01 $. При приёме задачи резервируется максимально возможная сумма, а после завершения списывается фактический расход с округлением вверх до целого кредита; остаток возвращается. За задачи, завершившиеся ошибкой, плата не взимается. Точную сумму до запуска покажет POST /api/v1/jobs/quote.

Создать картинку

bytedance/seedream-4.0/text-to-image

Цена

ВариантКредиты (за изображение)Доллары США
По умолчанию4.5$0.045

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
promptОбязательноstring——Describe the image to generate: subject, composition, style, and lighting.
sizeНеобязательноstring2048*20482048*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, … (+2)Output image size in pixels, written as width*height.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-4.0/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain"
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Редактировать картинку

bytedance/seedream-4.0/edit

Цена

ВариантКредиты (за изображение)Доллары США
По умолчанию4.5$0.045

Параметры

ПолеТипПо умолчаниюДопустимые значенияНазначение
promptОбязательноstring——Describe the image to produce from the source: subject, composition, style, and lighting.
image_urlsОбязательноarray<string (uri)>—до 10 элементовSource images that you are authorised to process.
sizeНеобязательноstring2048*20482048*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, … (+2)Output image size in pixels, written as width*height.

Пример запроса

Запрос работает как есть; поля, которые вы не указали, берут значения по умолчанию. Сначала положите ключ в переменную POPNOW_API_KEY.

В примере в image_urls стоят демонстрационные файлы PopNow. Замените их своими публичными HTTPS-ссылками, загруженными файлами или сохранёнными ассетами.

POST /api/v1/jobs/createTask?wait=60
curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "bytedance/seedream-4.0/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ]
  }
}'

В ответе сразу приходит taskId. Результат забирайте через GET /api/v1/jobs/recordInfo или передайте callBackUrl, чтобы получить уведомление.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Что дальше

На этой странице