ByteDance: Seedance 2.5
Seedance 2.5 совместно создаёт аудио и видео для более длинных сцен, использует разнообразные референсы изображений, видео и аудио и поддерживает точечные правки. ByteDance Seed документирует генерацию до 30 секунд, управление по рендеру без текстур, контролируемую работу камеры и продолжение готового материала.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
Seedance 2.5 — модель совместной генерации аудио и видео ByteDance Seed. Она развивает Seedance 2.0, добавляя длинное повествование, более богатые мультимодальные референсы и точный монтаж. Текстовое задание определяет сцену; изображения, видео и аудио передают внешность, движение, язык камеры и звук. Результат — аудиовизуальный материал для концепции фильма, продуктовой истории, клипа, превизуализации или короткого сюжета.
Полная сцена за одну генерацию Производитель увеличивает предел однопроходной генерации с прежних 15 до 30 секунд. Это даёт место завязке, развитию и завершению с несколькими связанными планами или непрерывным движением камеры. В примере сценического выступления певец проходит из гримёрной через коридор на сцену, а не только появляется на ней. Описывайте действия и маршрут камеры в нужном порядке. В продуктовой истории планируйте раскрытие, демонстрацию и финальную композицию так, чтобы каждый момент добавлял видимое содержание.
Продолжение готового материала Seedance 2.5 расширяет клип вперёд или назад, используя персонажей, окружение, движение и направление камеры для непрерывности. Продолжение вперёд описывает события после последнего момента, назад — подводку к началу. Передайте материал и объясните новое действие, смену обстановки или движение камеры. Проверяйте стык и новый сегмент, включая внешность, звук и направление движения. Анонс производителя обсуждает повторное расширение, страница модели — два шага расширения; доступный бюджет определяется конкретным сценарием, а не универсальным обещанием неограниченного видео.
Референсы изображений, видео и аудио Объявленный бюджет — до 50 материалов на генерацию: 30 изображений, 10 видеоклипов и 10 аудиоклипов. Изображения задают персонажей, продукты, места, реквизит или стиль; видео — исполнение, темп и камеру; аудио — диалог, музыку, атмосферу или ритм. Назначьте каждому ясную роль: референс объекта, окружения, видео движения камеры и аудио для тайминга. Материалы направляют интерпретацию, но не гарантируют точного воспроизведения всех деталей.
Управление по рендеру без текстур и постановка движения Трёхмерная сцена без текстур задаёт пространственное расположение, позы, траектории и ракурсы до создания итоговой внешности. Производитель показывает такую структуру вместе с отдельным изображением дизайна персонажа, материалов, цвета и атмосферы. Это полезно для анимации или сборочной визуализации, где постановка важнее свободного стилевого референса. Укажите, какой источник управляет постановкой, а какой — обликом. Пространственные подсказки также направляют свет, цветовую температуру, интенсивность и размещение теней.
Правки по времени и управление камерой Seedance 2.5 позволяет задать временной интервал при генерации и изменить персонажей, действия или сюжетные элементы готового клипа. Правка по временным меткам может касаться звука и изображения; определите интервал и изменяемый элемент. Производитель показывает замену фона зелёного экрана, правки по референсу и смену движения камеры с сохранением действия и стиля сцены. Задание должно назвать исходный клип, интервал, изменение и сохраняемую непрерывность. Например, задайте смену света или фона одного сегмента вместо переработки всего фильма. После правки проверьте моменты до и после интервала и изменённый материал.
Аудиовизуальный вывод и многоязычное создание Спецификация производителя описывает генерацию 4–30 секунд в 480p, 720p или 1080p, 24 FPS, с выходом MP4 или MOV. Официальное представление описывает встроенную поддержку более 10 языков и создание на основе диалога. Это возможности и форматы производителя, не контракт Ailoot на файловый вход, длительность или выход. Для диалоговой работы задайте речь и её связь с действием, затем поручите свободно владеющему языком человеку проверить текст и произношение локализованной версии.
Применения и существенные ограничения Модель полезна для концепций кампаний, показов продуктов, историй с персонажами и реалистичных превью по материалу или простой 3D-постановке. Производитель показывает также учебные объяснения и производственные или сборочные визуализации. Сгенерированный учебный или симуляционный материал всё равно нужно сверять с реальным процессом. Выпуск явно называет физику сложного движения и устойчивое взаимодействие нескольких объектов областями улучшения. Проверяйте контакт рук и предметов, групповые взаимодействия, траектории, постоянство персонажа и синхронизацию звука с изображением во всём клипе. Сильный первый кадр не доказывает соответствия всей последовательности заданию.
Ailoot Ultra · Видео POST /v1/videos bytedance/seedance-2.5
bytedance/seedance-2.5Начало
Seedance 2.5 совместно создаёт аудио и видео для более длинных сцен, использует разнообразные референсы изображений, видео и аудио и поддерживает точечные правки. ByteDance Seed документирует генерацию до 30 секунд, управление по рендеру без текстур, контролируемую работу камеры и продолжение готового материала.
- Допустимые входные данные
- Текст · Картинки · Аудио
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Видео POST /v1/videos
- Входные данные
text,image,audio- Результат
video- Выходной формат
- Исходные байты MP4; без нормализации и перекодирования
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения bytedance/seedance-2.5 | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения | По умолчанию— |
Полеduration | Типinteger | ТребованиеОбязательно | Значения и ограничения 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Минимум: 1 Максимум: 600 | По умолчанию— |
Полеresolution | Типstring | ТребованиеНеобязательно | Значения и ограничения 480p, 720p | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 16:9, 4:3, 1:1, 3:4, 9:16, 21:9 | По умолчанию— |
Полеgenerate_audio | Типboolean | ТребованиеНеобязательно | Значения и ограничения false, true Условия: Отсутствие generate_audio выбирает цену с аудио; false выбирает цену без аудио. Проверьте has_audio в результате, чтобы узнать, возвращена ли аудиодорожка. | По умолчанию— |
Полеframe_images | Типarray | ТребованиеНеобязательно | Значения и ограничения Минимум элементов: 1 Максимум элементов: 2 Входное содержимое: Массив объектов кадров. Каждый содержит type=image_url, image_url с url и frame_type=first_frame или last_frame. Каждая роль встречается не более одного раза. Используйте публичные HTTPS-ссылки. Точные ключи: type, image_url, frame_type Условия: Эти ключи применяются к каждому объекту кадра. Не передавайте frame_images для запроса только с текстом. | По умолчанию— |
Полеinput_references | Типarray | ТребованиеНеобязательно | Значения и ограничения Входное содержимое: Массив объектов референсных изображений или аудио. Укажите image_url или audio_url в type и передайте соответствующий объект URL, содержащий url. Стоимость видеореференсов по-прежнему невозможно определить. Условия: Не передавайте frame_images, чтобы использовать режим референсов. Используйте публичные HTTPS URL. | По умолчанию— |
Полеsize | Типstring | ТребованиеНеобязательно | Значения и ограничения 854x480, 752x560, 640x640, 560x752, 480x854, 992x432, 1280x720, 1112x834, 960x960, 834x1112, 720x1280, 1470x630 Шаблон: ^[1-9][0-9]*x[1-9][0-9]*$ Условия: Для размеров из списка, кроме 1280x720, не передавайте aspect_ratio. Можно совместить 1280x720 с 16:9. Если передаёте resolution, он должен соответствовать уровню 480p или 720p выбранного размера. | По умолчанию— |
Полеseed | Типinteger | ТребованиеНеобязательно | Значения и ограничения Минимум: -9 223 372 036 854 775 808 Максимум: 9 223 372 036 854 775 807 | По умолчанию— |
Полеcallback_url | Типstring | ТребованиеНеобязательно | Значения и ограничения Шаблон: ^https:// | По умолчанию— |
Полеsession_id | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеtrace | Типobject | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Полеuser | Типstring | ТребованиеНеобязательно | Значения и ограничения | По умолчанию— |
Сочетания входных материалов
Из текста в видео · Текстовый запрос. · Обязательно: model, prompt, duration
Передайте текстовый запрос и поддерживаемую длительность в целых секундах. Используйте точный размер из списка либо разрешение и соотношение сторон, дающие указанные в списке размеры.
model: Тип: string · bytedance/seedance-2.5
prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да
Из изображения в видео · Текстовый запрос и изображение кадра. · Обязательно: model, prompt, duration, frame_images
frame_images — массив объектов с type=image_url, image_url, содержащим url, и frame_type. Используйте публичный HTTPS URL изображения; first_frame и last_frame могут встречаться по одному разу. Используйте перечисленный размер результата или совместимые размеры. Не добавляйте видеореференсы.
Точные ключи: type, image_url, frame_type
model: Тип: string · bytedance/seedance-2.5
prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да
Reference to video · Текстовый запрос и референсные изображения или аудио. · Обязательно: model, prompt, duration, input_references
input_references — массив. Каждый объект содержит type=image_url или type=audio_url и соответствующий объект URL с url. Используйте публичные HTTPS-ссылки. Не передавайте frame_images, чтобы выбрать режим референсов. Стоимость видеореференсов определить невозможно.
model: Тип: string · bytedance/seedance-2.5
prompt: Тип: string · Максимум байтов UTF-8: 10 000 · Нужен хотя бы один непробельный символ: Да
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt, duration |
Параметрmaterial_types | Контрактtext, image, audio |
Параметрadditional_properties | Контрактfalse |
Параметрoptional_controls | Контрактresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Жизненный цикл: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Тарифы
Как рассчитывается итоговая плата
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
- Быстрый режим
- Не указано При выборе быстрого режима
- Режим flex
- Не указано При выборе режима flex
- Максимальная интенсивность рассуждений
- Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)
Оценочные ставки для сравнения
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётная единица | Условия расчёта | Плата |
|---|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётная единица— | Условия расчёта— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияЦена видеотокена | Шкала ставок— | Прогноз количества— | Расчётная единицаза 1K видеотокенов | Условия расчётаВ этом ключе цены дополнительное условие не объявлено. | Плата Выход · Цена видеотокена · Оценка только для сравнения $0.0214 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
| КонфигурацияЦена видеотокена | Шкала ставок— | Прогноз количества— | Расчётная единицаза 1K видеотокенов | Условия расчётавходные данные: with_video_input | Плата reference · Цена видеотокена · Оценка только для сравнения $0.0128 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
| КонфигурацияЦена видеотокена | Шкала ставок— | Прогноз количества— | Расчётная единицаза 1K видеотокенов | Условия расчётааудио: without_audio | Плата Выход · Цена видеотокена · Оценка только для сравнения $0.0214 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётная единица— | Условия расчёта— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.822402 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Сведения о справочном тарифе
Справочные шкалы модели не меняют выбор метода, расчёт стоимости или списания. Действующая плата определяется ставками выбранного метода Ailoot.
Ссылки на цены конфигураций видео
Цены по конфигурациям
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Условия расчёта | Плата |
|---|---|---|
| КонфигурацияЦена видеотокена | Условия расчётаВ этом ключе цены дополнительное условие не объявлено. | Плата Выход · Цена видеотокена $0.0214 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
| КонфигурацияЦена видеотокена | Условия расчётааудио: without_audio | Плата Выход · Цена видеотокена $0.0214 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
| КонфигурацияЦена видеотокена | Условия расчётавходные данные: with_video_input | Плата reference · Цена видеотокена $0.0128 за 1K видеотокенов Тариф за видеотокен — основной ориентир цены. Посекундные оценки в заголовке служат отдельными ориентирами, а не дополнительным списанием. |
Примеры запросов
Ailoot Ultra · Видео
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"model":"bytedance/seedance-2.5","prompt":"A serene mountain landscape at sunset","duration":4,"resolution":"480p","size":"854x480","generate_audio":false}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Получить и сохранить результаты
Ailoot Ultra · Видео
подписанные ссылки на содержимое, принадлежащее Ailoot
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Проверить статус задачи
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Чтение другого содержимого
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Сохраняйте все готовые результаты
Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала.
Сохраняйте каждый фактический результат, принадлежащий Ailoot, и возвращённые измеренные метаданные.
Если нужно проверить исходный ответ
503 result_pending_check + исходный id + X-Should-Retry:false; никогда не отправляйте исходный запрос повторно
Поля ответа
| Поле | Тип | Значение |
|---|---|---|
Полеindex | Типinteger | ЗначениеПозиция этого видео в списке результатов, начиная с нуля. |
Полеcontent_url | Типstring | ЗначениеПодписанный HTTPS URL для скачивания этого готового видео. |
Полеsha256 | Типstring | null | ЗначениеХэш SHA-256 исходных байтов видео; null, если недоступен. |
Полеsize_bytes | Типinteger | null | ЗначениеРазмер исходного видеофайла в байтах; null, если недоступен. |
Полеduration_ms | Типinteger | null | ЗначениеИзмеренная длительность видео в миллисекундах; null, если недоступна. |
Полеwidth | Типinteger | null | ЗначениеШирина видео в пикселях; null, если недоступна. |
Полеheight | Типinteger | null | ЗначениеВысота видео в пикселях; null, если недоступна. |
Полеvideo_codec | Типstring | null | ЗначениеИдентификатор видеокодека; null, если не записан. |
Полеhas_audio | Типboolean | null | ЗначениеЕсть ли у видео аудиодорожка; null, если не измерено. |
Полеaudio_codec | Типstring | null | ЗначениеИдентификатор аудиокодека; null, если идентификатор не записан. |
Ошибки и дальнейшие шаги
| Ответ | Условие | Следующий шаг |
|---|---|---|
Ответ404 · not_found_error | УсловиеДоступ к видео недоступен либо этот ID видео не найден. | Следующий шагПроверьте доступ к видео. Для существующего видео используйте исходный публичный ID и тот же ключ API. |
Ответ401 · authentication_error | УсловиеКлюч API не соответствует авторизованному аккаунту. | Следующий шагПеред отправкой проверьте ключ API и доступ к аккаунту. |
Ответ400 · invalid_request_error | УсловиеНе удалось прочитать запрос либо индекс скачивания недопустим. | Следующий шагИсправьте тело запроса. Для скачивания выберите индекс результата, возвращённый исходной задачей. |
Ответ422 · price_unavailable | УсловиеНевозможно определить цену выбранной конфигурации видео. | Следующий шагВыберите поддерживаемую конфигурацию видео и заполните обязательные параметры перед отправкой исправленного запроса. |
Ответ422 · invalid_request_error | УсловиеНедопустимы входное видео или исходная задача продолжения. | Следующий шагИспользуйте корректные входные HTTPS-ссылки. Для продолжения используйте исходный публичный ID вашего готового видео и тот же ключ API. |
Ответ402 · billing_error | УсловиеДоступный баланс или лимиты не позволяют зарезервировать средства. | Следующий шагПеред отправкой нового запроса проверьте доступный баланс и лимиты. |
Ответ503 · server_error | УсловиеПроверка видео, хранилище или доступ к сервису временно недоступны. | Следующий шагДождитесь доступности сервиса. Если у вас уже есть ID видео, проверяйте ту исходную задачу вместо создания новой генерации. |
Ответ503 · result_pending_check | УсловиеНужно проверить результат исходного видео и начисление. | Следующий шагСохраните возвращённый ID видео и проверьте эту задачу. Не отправляйте заменяющий запрос на генерацию, пока идёт проверка. |
Ответ503 · owned_result_unavailable | УсловиеСкачивание существующего видео временно недоступно. | Следующий шагПроверьте ту же видеозадачу позже и скачайте её существующий результат. Новая генерация создаёт отдельную операцию. |
Ответ409 · video_not_ready | УсловиеСодержимое видео не опубликовано. | Следующий шагПроверьте исходный статус задачи. Скачайте результат после completed; при failed следуйте уведомлению о проверке начисления. |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra bytedance/seedance-2.5
Псевдонимы путей метода
Используйте пути методов, указанные выше.
Связанные ID для вызова
FAQ · ByteDance: Seedance 2.5
- Какие входные данные и результаты доступны?
POST /v1/videos·bytedance/seedance-2.5:text,image,audio→video- Какие поля использует запрос?
POST /v1/videos·bytedance/seedance-2.5:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Какие ограничения действуют?
POST /v1/videos·bytedance/seedance-2.5:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807