Seedance 2.0 Mini API

Seedance 2.0 Mini в режиме «референсы в видео» сводит несколько разрешённых источников в один план: изображения отвечают за «кто» и «что», клипы — за движение и темп, аудио — за долю, на которую ложится склейка. Стартовый кадр этот режим не принимает.

Seedance 2.0 Mini — младший уровень линейки Seedance 2.0 от ByteDance. У него те же эндпоинты, что у Seedance 2.0 Fast, и он возвращает клипы на 4–15 секунд в 480p или 720p со звуком, созданным за тот же проход.

Выберите режим Seedance 2.0 Mini по исходному материалу

Тот же контракт, что у Seedance 2.0 Fast

У Mini те же эндпоинты и поля, что у Seedance 2.0 Fast: адаптивный формат и шесть фиксированных, от 4 до 15 секунд или -1, чтобы длину выбрала модель, нативный звук и seed, а разрешение ограничено 720p. Конвейер, написанный под Mini, переходит на Fast заменой идентификатора модели, а не запроса.

Для больших объёмов

Mini стоит выбирать, когда пропускная способность важнее дополнительного качества старших моделей Seedance 2.0. Все эндпоинты асинхронные: отправляйте Idempotency-Key с каждым запросом, сохраняйте идентификаторы задач и получайте результаты через опрос или колбэки. Ключ действует 24 часа, поэтому повтор после обрыва соединения вернёт исходную задачу.

Длинные последовательности через продление видео

Чтобы выйти за пятнадцать секунд, отправьте готовый клип на эндпоинт video-extend: его последний кадр открывает новый план Seedance 2.0 Mini, а в ответ вы получаете один файл с обеими частями. Каждый шаг оплачивает только добавленные секунды, а склеенный результат можно продлить снова.

Один набор референсов на всю серию

Три вида одного мужчины — анфас, в три четверти и в профиль — плюс четвёртое изображение его фартука могут держать целую серию, пока между запросами меняется только промпт. Опубликованный пример с пекарней построен именно так.

Темп, взятый из клипа

Референсный клип может задавать ритм, а не содержание. Один из примеров берёт из клипа неторопливый непрерывный наезд, ставит его в проходе из референсного изображения и совмещает шаги с пульсом референсной дорожки — восемь секунд в 9:16.

Пара, стабильная в разных ракурсах

Три изображения одной пары позволяют новому плану найти третий ракурс, сохранив лица и одежду, как в примере со скамейкой в парке, созданном в 480p.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "bytedance/seedance-2.0-mini/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "bitrate_mode": "standard",
    "duration_seconds": 5,
    "enable_web_search": false,
    "generate_audio": true,
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "reference_image_urls": [
      "https://example.com/reference.png"
    ]
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.