Как использовать API Seedance 2.5 через Ofox?

Создайте задачу генерации через POST https://api.ofox.ai/v1/videos, используя ваш Ofox API key, затем опрашивайте статус задачи до завершения и скачайте видео из mirror_urls (или unsigned_urls).

Что делать, если генерация не удалась?

Сохраните ID задачи, сначала проверьте статус и сообщение об ошибке, затем решайте — поправить параметры или создать задачу заново. Пока результат неясен, не отправляйте запросы подряд; списывается ли плата за неудачные запуски, определяют фактические правила сервиса и счёт.

Первый/последний кадр и референсные изображения — это одно и то же?

Нет. Первый и последний кадры задают картинку в начале или конце видео и передаются через frame_images; обычные референсы направляют объект, стиль и т. п. и передаются через input_references. В одном запросе их использовать вместе нельзя.

Почему пример не меняется после правки промпта?

Примеры в рабочей области — прошлые результаты исходных промптов; они помогают оценить качество. Ваши правки сразу попадают в API-запрос; после нажатия «Сгенерировать видео» новая задача будет создана в студии OfoxAI.

Подходит ли Seedance 2.5 для видео со звуком?

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

Как сравнить Seedance 2.5 с другими видеомоделями?

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

Можно ли напрямую редактировать или продолжить готовое видео?

«Видеореференс» — это не редактирование и не продолжение. Инструкции и эндпоинты для редактирования и продолжения нужно проверять отдельно; в рабочей области нет непроверенных переключателей редактирования или продолжения.

Почему заявленное число референсов может отличаться от ограничений API?

Максимальные возможности модели — не то же самое, что поддерживают все поставщики, эндпоинты шлюза и веб-формы. Ориентируйтесь на ограничения эндпоинта, который вы вызываете; если материалов много и они разнотипные, сначала проверьте на минимальном примере, затем постепенно наращивайте.

Включает ли тестовый бюджет бесплатные кредиты?

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

Seedance 2.5

Video Generation

bytedance/seedance-2.5

Начните с одного плана — и пусть идея оживёт.

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

4–30 сна ролик
480p–1080pразрешение
Синхронный звукпо желанию

Попробовать видео Посмотреть API-запрос

Оплата за сгенерированные секунды · бюджет запуска — рядом с параметрами

Seedance 2.5 — мультимодальная модель создания видео нового поколения из линейки Doubao от ByteDance, выпущенная 2026-08-07. Она принимает смешанный ввод из текста, изображений, видео и аудио — до 30 изображений, 10 видео и 10 аудиоклипов, всего до 50 референсных материалов — и поддерживает генерацию видео из текста, из изображения и из видео. Длительность одного клипа задаётся любым целым числом секунд от 4 до 30, разрешение — 480p, 720p или 1080p (по умолчанию 720p), доступны шесть соотношений сторон и адаптивный вариант. Вывод по умолчанию содержит синхронизированное аудио, а промпты можно писать на разных языках. В этом поколении улучшены следование инструкциям, многокадровое повествование и согласованность на длинных отрезках. Доступна через OpenAI-compatible протокол.

Промпт

867 / 4000

15 с × $0.24/с · Генерация в студии OfoxAI, нужен вход в аккаунт · Расчёт цены и бюджет на несколько раундов ↓

Один дубль через весь круизный лайнер

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

Seedance 2.5720p · 15 с · 16:9 · без звукаРеальный результат

# 1. Create the generation task — keep the returned idcurl https://api.ofox.ai/v1/videos \  -H "Authorization: Bearer $OFOX_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "model": "bytedance/seedance-2.5",  "prompt": "Continuous single take, camera tilting, rolling, spinning, flying through a colossal luxury cruise ship. Starts flying over the sunny upper deck dodging beach balls and sunbathers, camera dives straight down a twisting, translucent water slide, gliding past screaming children before splashing into the main pool. Sweeps underwater, effortlessly passing through a glass floor directly into the elegant grand dining room below, weaving through crystal chandeliers, clinking champagne glasses, and waiters balancing silver trays. Camera dives past the spinning kitchen doors into the humming, immaculate engine control room, transitions out the stern exhaust vent, gliding over the churning, foamy white wake as the sun sets over the ocean. No cuts, impossible camera moves, seamless transitions, energetic, dynamic, cinematic. 8K high definition, high quality footage.",  "duration": 15,  "resolution": "720p",  "aspect_ratio": "16:9",  "generate_audio": false,  "provider": {    "type": "byteplus"  }}' # Or: "provider": { "type": "volcengine" } # 2. Poll with that id until status is completed / failed / cancelled / expiredcurl https://api.ofox.ai/v1/videos/$TASK_ID \  -H "Authorization: Bearer $OFOX_API_KEY" # 3. Read mirror_urls[0] (persistent), or unsigned_urls[0] (expires in ~24h)

ДальшеGET /v1/videos/{id} → mirror_urls[0]Полный процесс подключения ↓

Сменить примерНажмите на пример, чтобы подставить его исходный промпт и параметры · Источники примеров ↗

Сначала разберитесь в модели, потом выбирайте способ входа

Что умеет Seedance 2.5?

Seedance 2.5 — модель генерации видео от ByteDance. Она превращает описания сцен и референсные материалы в динамичные планы и поддерживает синхронный звук; в Ofox подключается через единый API видеозадач.

Источник характеристик модели

Сначала решите, что вы хотите контролировать

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

Текст → видео
Подходит, чтобы сначала проверить визуальное направление. Опишите объект, действие, сцену и камеру — готовить референсы заранее не нужно.
Сначала проверьте:Понятен ли объект и завершено ли действие.
Изображение → видео
Первый кадр задаёт отправную точку плана, последний ограничивает финальную картинку. Обычные референсные изображения направляют объект и стиль — у них другая роль.
Сначала проверьте:Начальный и конечный кадры, детали объекта и переход.
Видео → генерация по референсу
Подходит, чтобы передать замысел по движению, композиции или ритму. Укажите, что взять из референса и что изменить, — не пишите просто «сделай так же».
Сначала проверьте:Подходит ли движение и не используется ли референс не по назначению.

Длительность: 4–30s
Любое целое число секунд, до 30 с на ролик
Выходное разрешение: 1080p
До 1080p, по умолчанию 720p
Соотношение сторон: 7форматов кадра
21:916:94:31:13:49:16Адаптивно
Звук: Синхронный звук
Картинка и звук за один проход, можно включить или выключить
Вход: 3вида входных данных
ТекстПервый и последний кадрыРеференсное видео

Больше референсов — не значит больше контроля. Укажите назначение каждого материала: кто объект, где сцена, какое движение нужно сохранить. Не допускайте, чтобы несколько противоречащих описаний боролись за один и тот же план.

Релиз 2026-08-07bytedance/seedance-2.5

Возможности модели, поддержка у поставщика и ограничения API — три разных уровня. Число референсов, размер материалов и доступные комбинации зависят от выбранного эндпоинта; рабочая область демонстрирует только один видеореференс или первый/последний кадр и не выдаёт заявленные максимумы модели за возможности формы.

Результат, который видно

Смотрите не только на ролик, но и на то, как он снят

6 разных задач — 6 исходных промптов. Обратите внимание на движение, материалы и людей, а затем решите, подходит ли это вашему проекту.

Больше примеров промптов

Движение камеры · один дубль

Пять пространств без монтажа

Палуба, горка, бассейн, ресторан, машинное отделение — всё одним проходом. Следите, плавны ли переходы и не путается ли пространство.

Товар · вертикальная реклама

Реклама десерта в два абзаца

В промпте всего два абзаца. Оцените свет, слои ингредиентов и чистоту белого фона — годится ли это сразу для e-commerce.

Персонаж · нативный звук

Раскадровка по таймлайну — вместе со звуком

Для каждого из трёх планов прописаны картинка и звук. Проверьте единство персонажа и соответствие звуков фортепиано движениям пальцев.

Анимация · эмоциональная игра

Взаимодействие двух персонажей

Поворот головы, касание носами, объятие; камера наезжает от среднего плана к крупному. Оцените, правдоподобны ли связки движений и смена эмоций.

Таймлапс · непрерывная деформация

Медленная деформация должна быть стабильной

Лепестки раскрываются один за другим на чистом градиентном фоне. Замедлите воспроизведение и проверьте, нет ли пропущенных кадров или мерцания.

Несколько планов · монтаж в такт

Десять планов — вечеринка за пятнадцать секунд

Крупность и движение камеры каждого плана расписаны по секундам, есть нативный звук. Оцените, едины ли ритм, стиль и переходы.

Откуда примеры и условия теста ›

Примеры реально сгенерированы OfoxAI с помощью bytedance/seedance-2.5, а промпты — дословный текст, использованный при генерации. Разрешение, длительность, соотношение сторон и наличие звуковой дорожки указаны на каждом примере, а кнопка «Повторить этот план» подставит те же параметры. Примеры служат только для оценки качества: они не отражают долю успешных генераций и не являются выводом о сравнении с другими моделями.

Промпт должен управлять съёмкой

Не пишите просто «кинематографично» — опишите, что происходит в кадре

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

01
Объект и сцена
Кто и где; какие узнаваемые детали нужно сохранить.
02
Основное действие
Как действие начинается, как меняется и где заканчивается.
03
Камера и композиция
Крупность плана, направление движения, горизонтальный или вертикальный кадр, допустима ли смена планов.
04
Звук и ограничения
Фоновый звук или без звука; текст, логотипы или действия, которых не должно быть.

Выберите отправную точку

Чётко показать одну деталь продукта

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

Черновик промптаПредметная съёмка · 5 с, горизонтально

Керамическая кружка без логотипа стоит на чистом деревянном столе. Камера медленно наезжает со среднего плана к краю кружки, мягкий боковой свет скользит по глазури. Кружка неподвижна, фон простой, весь ролик — один непрерывный наезд. 5 секунд, 16:9, без субтитров, без лишнего текста, без звука.

Подготовьте:: Точное описание продукта; если есть фото продукта, используйте его как первый кадр.
Критерий приёмки:: Не искажаются ли контур, маркировка и конструкция.

Захватить внимание одним действием

Постройте начало и конец вокруг одного понятного действия. Оставьте место для субтитров на постпродакшене — не поручайте генерации картинки сложный текст.

Черновик промптаДействие объекта · 5 с, вертикально

Взрослый человек в однотонном спортивном костюме в светлой студии делает один поворот и в конце уверенно встаёт лицом к камере. Камера держит фиксированный план в полный рост, объект всё время в центре кадра; одежда и конечности двигаются естественно. 5 секунд, вертикально 9:16, один план, без субтитров, текста и логотипов, без звука.

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

Двигать сюжет через реакцию персонажа

Сначала опишите положение персонажа, действие и эмоциональный поворот. Не прячьте неясные отношения между персонажами за частой сменой планов.

Черновик промптаСмена эмоций · 10 с, горизонтально

Взрослый человек сидит у тихого окна; сначала он смотрит вниз на конверт на столе, затем медленно поднимает голову и смотрит в окно, а выражение лица сменяется с нерешительности на спокойствие. Камера медленно наезжает со среднего плана и останавливается на крупном плане лица; костюм и обстановка не меняются. 10 секунд, 16:9, один план, без субтитров, без лишнего текста, без звука.

Подготовьте:: Отношения персонажей, костюмы и порядок планов.
Критерий приёмки:: Сохраняется ли непрерывность мимики, костюмов, переднего и заднего плана.

Понятно показать процесс

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

Черновик промптаДемонстрация процесса · 8 с, горизонтально

Съёмка сверху: чистый деревянный верстак. Руки складывают квадратный лист бумаги пополам, затем ещё раз пополам и в итоге делают простой бумажный кораблик, который ставят в центр стола. Камера неподвижна; движения рук чёткие и равномерные, сгибы и деформация бумаги выглядят достоверно. 8 секунд, 16:9, один план, без субтитров, без лишнего текста, без звука.

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

Заменит промпт, режим и настройки в Playground; генерация не запустится автоматически.

Меняйте одну переменную за раз

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

Сначала о стоимости

Сколько стоит один ролик — и три попытки?

Бюджет следует за текущей конфигурацией. Сначала проверьте направление на коротких роликах, потом решайте, увеличивать ли длительность или разрешение.

Тестовый бюджет текущей конфигурации

Текст в видео · 720p · 15 с

Одно видео

$3.60

Итого за 3 раунда

$10.80

План: 3 раунда

Ожидаемая стоимость$10.80

Это не минимальная сумма пополнения. Число тестов не равно числу готовых роликов; фактическое списание — по актуальному счёту.

Оплата за каждую сгенерированную секунду
Разрешение	Текст в видео / с	Видео в видео / с
480p	$0.11/с	$0.14/с
720p	$0.24/с	$0.3/с
1080p	$0.6/с	$0.71/с

Цены — актуальные котировки Ofox, те же, что использует бюджет слева. Изображение в видео в этой таблице отдельно не указано, поэтому его цена не предполагается. Для указанных ценовых уровней звук — «любой». Эту модель обслуживают несколько платформ; выбрать платформу можно полем provider.type в запросе.

Источник актуальных цен

Разбейте первую проверку на три этапа

Ниже — рекомендуемые тестовые конфигурации для текста в видео; стоимость считается в реальном времени по текущим ценам.

01 / Направление4 с · 480p$0.44/ запуск
С минимальными затратами убедитесь, что объект и действие поняты верно; если нет — правьте промпт и повторяйте, не повышая конфигурацию.
02 / Детали5 с · 720p$1.20/ запуск
Переходите к финальной конфигурации, только когда структура, края, контакт и непрерывность в порядке; проблемы доводите до результата на этом уровне.
03 / Финальная проверка5 с · 1080p$3.00/ запуск
Используйте только после того, как направление и детали утверждены, — чтобы проверить итоговый результат в целевом разрешении.

От пробы к разработке

Нравится план? Подключите те же настройки к приложению

Создайте видеозадачу с текущим промптом и параметрами — не нужно заново собирать запрос по документации.

1POST /v1/videos
Создать видеозадачу
Отправьте модель, промпт, длительность, разрешение и настройку звука. Референсные материалы добавляются в запрос в зависимости от режима.
2GET /v1/videos/{id}
Проверить статус генерации
Сохраните возвращённый ID задачи. Опрашивайте до завершения, сбоя, отмены или истечения срока; не создавайте одну и ту же задачу повторно.
3mirror_urls / unsigned_urls
Получить видео
Сначала проверьте статус задачи, затем читайте адрес результата. В приоритете mirror_urls; если их нет, используйте unsigned_urls.

Эндпоинты и поля — по официальным примерам кода.

Документация для разработчиков

Какую задачу решает каждое поле?

Все поля и примеры запросов

Что вы хотите передатьПоле OfoxНа что обратить внимание

Какая модель: model; На этой странице зафиксирована Seedance 2.5; не используйте ID маршрутизации других платформ.
Что происходит: prompt; Опишите объект, действие, камеру и конечное состояние; задачам с референсом описание тоже нужно.
Длительность и параметры кадра: duration / resolution / aspect_ratio; Ручная длительность на этой странице — 4–30 с; задачи с первым/последним кадром используют адаптивное соотношение сторон.
Зафиксировать начало или конец: frame_images; Роль кадра задаётся через first_frame / last_frame; нельзя смешивать с обычными полями референсов.
Направлять содержание или стиль: input_references; Референсы-изображения, аудио и видео — не точные якоря кадров; ограничения определяются текущим эндпоинтом.
Генерировать ли звук: generate_audio; Управляется отдельно от качества картинки. Если в примере звук выключен, это не значит, что модель его не поддерживает.
Указать платформу: provider.type; Если модель обслуживают несколько платформ, без указания запросы распределяются по весам; чтобы закрепить платформу, укажите её здесь.

Где чаще всего застревают при первом подключении?

Сначала отличите «не принято» от «принято, но не завершено». Если создание вернуло ID задачи, в первую очередь опрашивайте именно её.

Параметры или материалы не подходят

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

Проблемы с аккаунтом или балансом

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

Задача всё ещё ожидает

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

Результат нужно хранить долго

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

Уже есть рабочий процесс с Agent?

Передайте задачу целиком, а не просто «сгенерируй видео»

Укажите цель, длительность, формат кадра, назначение материалов, лимит бюджета и критерии приёмки. Пусть Agent сначала покажет запрос и ожидаемую стоимость и создаст задачу только после вашего подтверждения, сохранит ID задачи и вернёт результат или понятную ошибку.

Это копируемое описание задачи: оно не подключает никакой Agent и не выполняет вызовов; ключи остаются в серверном окружении.

Вопросы перед стартом

Seedance 2.5: частые вопросы

Seedance 2.5 на Ofox.ai стоит от $0.11 за секунду сгенерированного видео. Точная ставка зависит от разрешения, режима генерации и звука. Оплата по факту использования, без ежемесячных платежей.