bytedance/seedream-5.0-pro/editОт 6 кредитов за изображение· Редактировать картинку

Редактирование Seedream 5.0 Pro принимает от одного до десяти референсов и инструкцию и возвращает одно изображение. Правьте одно фото или собирайте героя, одежду и декорации в один кадр; пятнадцать соотношений сторон в 1K или 2K.

Вызывайте его по имени модели bytedance/seedream-5.0-pro/edit через POST /jobs/createTask, от 6 кредитов за изображение (0,06 $). Новые аккаунты получают 30 бесплатных кредитов, чтобы вы могли сначала попробовать в Playground.

  • Создать картинку
  • Редактировать картинку
  • Разделение на слои
  • До 2K
  • До 10 референсов
  • Соотношений сторон: 15

Пока это руководство есть только на английском. →

Параметры запроса

ПараметрОбязательныйОписание
aspect_ratioНетФорма кадра: широкая, квадратная или вертикальная. auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 4:5 · 5:4 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · По умолчанию: auto
backgroundНетОставить, убрать или заменить фон. opaque · transparent · По умолчанию: opaque
enable_thinkingНетRun a thinking pass that refines the prompt before generating. Off is faster. По умолчанию: true
image_urlsДаФото для правки или объединения. В промпте укажите, что берётся из каждого.
output_formatНетФормат файла результата. jpeg · png · По умолчанию: jpeg
promptДаDescribe the image to produce from the source: subject, composition, style, and lighting.
resolutionНетРазмер результата. Больше — чётче и дороже. 1k · 2k · По умолчанию: 2k

Цены

Цены указаны в кредитах, тех же, что вы используете на сайте (1 кредит = $0,01). Сумма резервируется, когда задача принята, и пересчитывается по фактической стоимости после завершения; за неудавшиеся задачи кредиты возвращаются.

ВариантКредиты за изображение≈ USD
resolution 1K5,40,054 $
resolution 2K10,80,11 $

Каждая задача округляется вверх до целых кредитов, поэтому один запуск на самом дешёвом уровне стоит 6 кредитов за изображение (0,06 $).

Чтобы узнать точную сумму до запуска, отправьте то же тело запроса на POST /jobs/quote.

Быстрый старт API

Вызов API Seedream 5.0 Pro в три шага

  1. Создайте API-ключ. Войдите в PopNow и создайте ключ в консоли API. Ключи начинаются с sk-popnow- и списывают те же кредиты, что и сайт.
  2. Отправьте запрос. Отправьте POST /jobs/createTask с model bytedance/seedream-5.0-pro/edit и объектом input по таблице параметров. В ответе сразу придёт ID задачи.
  3. Получите результат. Опрашивайте 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/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "auto",
    "resolution": "2k",
    "output_format": "jpeg",
    "background": "opaque"
  }
}'

# 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 стоит от 6 кредитов (0,06 $) за изображение — на самой дешёвой задаче «Редактировать картинку». Цены по вариантам: 1K 5,4 кредита за изображение, 2K 10,8 кредита за изображение. Кредиты те же, что и на сайте (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?

Разрешения: 1K · 2K; Соотношения сторон: auto · 1:1 · 4:3 · 3:4 · 16:9 · 9:16 +10; Референсные изображения: 10; Длина промпта (символов): 5,000. Запросы за пределами этих ограничений отклоняются до любого списания.

Можно попробовать 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