Введение
Seedance 2.0 Fast в режиме «референсы в видео» сводит несколько разрешённых источников в один план: изображения отвечают за «кто» и «что», клипы — за движение и темп, аудио — за долю, на которую ложится склейка. Стартовый кадр этот режим не принимает.
Seedance 2.0 Fast — быстрый уровень линейки Seedance 2.0 от ByteDance. Его эндпоинты возвращают клипы на 4–15 секунд в 480p или 720p со звуком, который генерируется вместе с картинкой.
Выберите режим Seedance 2.0 Fast по исходному материалу
| Исходный материал | Режим |
|---|---|
| Сценарий или описание сцены | Seedance 2.0 Fast Текст в видео |
| Утверждённый стартовый кадр | Seedance 2.0 Fast Изображение в видео |
| Отдельные референсы внешности, движения или звука | Seedance 2.0 Fast Референсы в видео |
Ключевые возможности и особенности
Один набор полей, три источника
Все три эндпоинта принимают одни и те же базовые поля: prompt, duration_seconds от 4 до 15 (или -1, чтобы длину выбрала модель), resolution 480p или 720p, aspect_ratio, generate_audio и seed. Меняется только источник, который закрепляет картинку: ничего, стартовый кадр или набор референсов. Запрос переходит в другой режим, если добавить или убрать этот источник.
Картинка и звук за один проход
generate_audio включён по умолчанию и создаёт фон, звуки движения и голос, синхронизированные с кадрами. На этом уровне выключение не снижает тариф, поэтому отключайте звук только для беззвучных лупов или материала, который будете озвучивать на постпродакшне.
Адаптивный формат по умолчанию
aspect_ratio по умолчанию равен adaptive: режим «изображение в видео» сохраняет пропорции стартового кадра, «референсы в видео» следует главному референсу, а в режиме «текст в видео» модель выбирает форму, которую подсказывает промпт. Шесть фиксированных форматов — 16:9, 9:16, 4:3, 3:4, 1:1 и 21:9 — доступны, когда площадка задаёт форму.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Обязателен, и здесь он же занимается кастингом. Не менее 1 символов |
reference_image_urls | Нет | До 9 изображений, которые вы вправе использовать: персонаж, товар, стиль или декорация. Два-три ракурса одного объекта дают больше, чем стопка почти одинаковых кадров. Не более 9 элементов |
reference_video_urls | Нет | До 3 клипов, дающих движение, темп или язык камеры. Не более 3 элементов |
reference_audio_urls | Нет | До 3 аудиофайлов, каждый от 2 до 15 секунд и не больше 15 секунд вместе, каждый меньше 15 МБ. Не более 3 элементов |
aspect_ratio | Нет | Кадрирование результата, по умолчанию adaptive: ролик берёт форму основного референса. |
resolution | Нет | Разрешение результата: 480p или 720p по умолчанию. Оно выбирает тарифную ступень и не сделает низкокачественные референсы резче. |
duration_seconds | Нет | Длина готового ролика в целых секундах, от 4 до 15, по умолчанию 5; при -1 длину выбирает модель, а оценка исходит из 15 секунд. |
generate_audio | Нет | Рендерится ли родная дорожка синхронно с картинкой. Включён по умолчанию; если его выключить, тариф в этой версии не снижается. По умолчанию: |
seed | Нет | Целочисленный seed; уберите его — и каждый прогон возьмёт свой. Зафиксируйте при неизменном остальном, чтобы понять, что на самом деле изменила правка prompt. |
return_last_frame | Нет | Дополнительно возвращает последний кадр ролика отдельным изображением рядом с видео. По умолчанию: |
bitrate_mode | Нет | Битрейт выдаваемого файла: |
watermark | Нет | Добавляет в видео видимый водяной знак «AI generated» самой модели. По умолчанию: |
Стоимость
Референсные клипы добавляются к оплачиваемым секундам. Поскольку измерить ваши клипы до запуска невозможно, мы сначала резервируем сумму за максимальные 15 секунд, а неиспользованную часть возвращаем сразу при расчёте — оплачиваются только фактически использованные секунды.
| Разрешение | With video: Да | With video: Нет |
|---|---|---|
| $0.022539 / секунду | $0.04499712 / секунду |
| $0.048471 / секунду | $0.096768 / секунду |
Сценарии использования
Товар со всех сторон
Два-три ракурса одного предмета удерживают его гораздо лучше, чем стопка почти одинаковых снимков. Опубликованный пример отправляет три вида одного кроссовка и просит вращение на невидимом поворотном столе через эти виды по порядку, сохраняя фактуру кожи, подошву и шнуровку.
Заимствованное движение камеры
Референсный клип может задавать язык камеры, а не содержание. Один из примеров берёт из клипа медленный подъём на кране, ставит его над крышей из референсного изображения и совмещает верхнюю точку подъёма с нарастанием в референсной дорожке.
Постоянный каст в серии роликов
Держите один набор референсов для персонажа, предмета одежды или помещения и меняйте между запросами только промпт. Одни и те же изображения держат каждый эпизод, поэтому идентичность сохраняется, пока действие движется дальше.
Руководство по промптам и практические советы
Раздайте роли в промпте
Здесь промпт обязателен и именно он распределяет роли. Референсы читаются в порядке отправки, поэтому напишите, какое изображение — какой персонаж, что даёт каждый клип и зачем нужно аудио. Обозначения @Image1, @Image2 и так далее убирают любую двусмысленность.
Не выходите за лимиты референсов
reference_image_urls принимает до 9 изображений, reference_video_urls — до 3 клипов, reference_audio_urls — до 3 дорожек. Нужно хотя бы одно изображение или клип: одно аудио отклоняется. Клипы и аудио длятся от 2 до 15 секунд каждый и не более 15 секунд вместе, а секунды референсных клипов оплачиваются сверх результата, так что обрежьте их до нужного фрагмента.
Адаптируйте пример
Опубликованный пример использует aspect_ratio 1:1, duration_seconds 5, generate_audio true и resolution 720p, с тремя фото товара в reference_image_urls.
Treat @Image1, @Image2 and @Image3 as three angles of one sneaker. Rotate it smoothly on an invisible turntable through those three views in order, keeping the leather grain, gum sole and lacing identical throughout. Hard studio key stays fixed; the contact shadow swings with the rotation.
Каждый референс назван по позиции и получает одну задачу. Замените товар и сохраните эту структуру.
Когда первый кадр должен быть точным, используйте «изображение в видео»
У этого эндпоинта нет полей стартового и финального кадра. Если начальная картинка должна в точности совпадать со снимком, отправьте этот снимок в режим «изображение в видео» и опишите только движение.
Быстрый старт API
# 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-fast/reference-to-video",
"input": {
"aspect_ratio": "adaptive",
"bitrate_mode": "standard",
"duration_seconds": 5,
"generate_audio": true,
"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.
















