Seedance 2.5 API

Seedance 2.5 Референсы в видео строит новую последовательность из материалов, задающих её внешний вид, движение или звуковую дорожку. Выбирайте этот режим, когда изображение персонажа, локация, референс камеры и аудиодорожка должны отвечать каждый за свою часть брифа.

ByteDance представила Seedance 2.5 в статье о запуске от 31 июля 2026 года, назвав гибкое создание по референсам одной из центральных возможностей. Этот эндпоинт нужен, чтобы собрать такие указания в новое видео, а не чтобы закрепить присланное фото как первый кадр.

Выберите отправную точку для последовательности Seedance 2.5

Более длинные истории за одну генерацию

Seedance 2.5 поддерживает клипы до 30 секунд, и последовательности хватает места на завязку, развитие и финал. Его повествовательные возможности включают связанные планы и переходы между сценами, а не только растягивание одного жеста.

Гибкие мультимодальные референсы

Изображения, видео и аудио могут управлять разными элементами одной постановки. Расширенный процесс работы с референсами поддерживает более сложный каст, локации и раскадровку, отделяя внешность от движения и звука.

Подсказки из клей-рендеров и раскадровок

Черновое 3D-видео для планирования передаёт устройство пространства, мизансцену и движение камеры, а визуальные референсы задают итоговый облик. Раскадровки и упорядоченные ключевые кадры — ещё один способ передать последовательность.

Более детальная режиссура картинки и звука

При разработке модели упор сделан на материалы, свет, детали кожи и глаз, а также на согласованность звука и движения. В промпте можно раздельно задать диалоги, эффекты и фон и упорядочить события отметками времени в целых секундах.

Точечное редактирование и продолжение

Семейство модели включает редактирование видео по временным отрезкам, замену фона и продолжение существующего материала. Это отдельные процессы с видео на входе; их доступность и настройки зависят от выбранной задачи, а не от запроса «текст в видео» или «изображение в видео».

Персонаж, декорация и план камеры вместе

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

Черновая репетиция камеры превращается в стилизованную сцену

Используйте простое видео для планирования движения и референс облика для материалов и света. Поясните, какие части планировочного видео нужно игнорировать. Проверяйте пространственные отношения, а не считайте сгенерированную геометрию точной.

Набросок видеоряда к разрешённой аудиодорожке

Загрузите звуковой референс и опишите образы, настроение и действия, которые должны его сопровождать. Проверьте, как музыкальные или речевые акценты соотносятся с картинкой; точная синхронизация с ритмом не гарантируется.

# 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.5/reference-to-video",
  "input": {
    "aspect_ratio": "adaptive",
    "duration_seconds": 5,
    "generate_audio": true,
    "output_format": "mp4",
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "resolution": "720p",
    "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.