Seedance 2.5 Text to Video

Обзор

Seedance 2.5 от ByteDance Seed официально представлена в июле 2026 года. Режим Text to Video — базовый текстовый endpoint линейки 2.5: создаёт ролики длительностью 4–30 секунд с нативным аудио в разрешениях до 4K (также 480p, 720p и 1080p). По сравнению с Seedance 2.0 Text to Video (короче клип, потолок 1080p и меньше референсов) версия 2.5 рассчитана на длинный нарратив «в один проход»: лучше держит сюжетную связность между планами, переходы камеры и аудиовизуальную согласованность. Главное отличие — расширенные мультимодальные референсы: до 30 изображений, 10 видео и 10 аудио за один запрос, плюс усиленный контроль через clay render, motion и creative references. Пользователь задаёт сцену текстом, при необходимости добавляет референсы персонажей, стиля или движения, выбирает формат кадра, длительность и разрешение, включает генерацию звука. Самое важное: это endpoint для законченных коротких историй и продакшен-сцен, а не для мгновенных черновиков. Ограничения: сложная физика движений и взаимодействие многих субъектов всё ещё требуют проверки и итераций.

Сильные стороны

Сценари использования (use cases)

Ограничения и недостатки

Советы

• Привязывайте каждый референс к роли через @Image / @Video / @Audio и явно пишите, что из файла брать нельзя Seedance 2.5 принимает до 50 мультимодальных ассетов, но без явной привязки модель смешивает лица, фон и движение. Формулировки вроде «@Image 1 — только лицо и одежда, фон не использовать» заметно стабилизируют результат. Это ключевой приём официального prompting guide для 2.5.
• Для роликов 10–30 с разбивайте сюжет на этапы: одно главное изменение и видимое конечное состояние на этап Один проход до 30 секунд — сильная сторона Seedance 2.5, но без структуры действие «уплывает» во второй половине. Шаблон «открытие → одно событие → конец кадра» плюс блок стабильности (одежда, число персонажей, кто держит реквизит) удерживает связность. Для обычного нарратива этапы надёжнее плотной сетки секундных меток.
• Разделяйте звук скобками: () музыка, <> эффекты, {} диалог, 【】 субтитры; язык реплики указывайте до строки В Seedance 2.5 аудио рождается вместе с картинкой, и скобочный синтаксис из официального guide резко снижает путаницу каналов — когда реплика рисуется как титр или шум озвучивается как речь. Для некитайского диалога сначала задайте язык, акцент и подачу, а в {} оставьте только слова. Субтитры — отдельный канал: если нужны и речь, и текст на экране, продублируйте строку в 【】.
• Не заполняйте все 50 слотов референсов «на всякий случай» 50 ассетов — потолок API, а не целевой объём: официальный guide прямо даёт более узкие рекомендуемые диапазоны (примерно 1–8 субъектов в изображениях, 1–5 в видео). Чем больше слабо размеченных файлов, тем чаще падает стабильность идентичности и ролей. Курируйте небольшой набор и одну роль на файл.
• Не сваливайте несколько несвязанных событий в один этап без конечного состояния Когда в одном отрезке конкурируют два действия, модель делит «бюджет движения» и переходы становятся мягкими или рваными — типичная причина дрейфа на длинных 20–30‑секундных клипах. Одно главное изменение на этап и явное «кадр заканчивается тем, что…» удерживают таймлайн. Несвязанные сцены лучше разнести по этапам или отдельным генерациям.

FAQ

Цены

Параметры

Поля тела JSON-запроса, которые используются в Playground и доступны для настройки через API. Порядок совпадает с формой на странице.

Запрос

Асинхронный запуск: POST https://api.flixa.io/v1/video/seedance-2.5/text-to-video с заголовком Authorization: Bearer $FLIXA_API_KEY и телом JSON. Ниже — пример с полями из Playground.

curl -X POST "https://api.flixa.io/v1/video/seedance-2.5/text-to-video" \
  -H "Authorization: Bearer $FLIXA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Превратите это фото товара в премиальную студийную рекламу: мягкий кинематографический свет, чистый бежевый фон, лёгкие тени, реалистичные отражения и эстетика люксового бренда.",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "reference_audios": [],
  "reference_images": [],
  "reference_videos": []
}'

import json
import os
import requests

url = "https://api.flixa.io/v1/video/seedance-2.5/text-to-video"
payload = json.loads({"aspect_ratio": "16:9", "duration": 5, "generate_audio": true, "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "reference_audios": [], "reference_images": [], "reference_videos": [], "resolution": "720p"})

response = requests.post(
    url,
    headers={"Authorization": f"Bearer {os.environ['FLIXA_API_KEY']}"},
    json=payload,
    timeout=120,
)
print(response.json())

const response = await fetch(
  "https://api.flixa.io/v1/video/seedance-2.5/text-to-video",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.FLIXA_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"aspect_ratio": "16:9", "duration": 5, "generate_audio": true, "prompt": "\u041f\u0440\u0435\u0432\u0440\u0430\u0442\u0438\u0442\u0435 \u044d\u0442\u043e \u0444\u043e\u0442\u043e \u0442\u043e\u0432\u0430\u0440\u0430 \u0432 \u043f\u0440\u0435\u043c\u0438\u0430\u043b\u044c\u043d\u0443\u044e \u0441\u0442\u0443\u0434\u0438\u0439\u043d\u0443\u044e \u0440\u0435\u043a\u043b\u0430\u043c\u0443: \u043c\u044f\u0433\u043a\u0438\u0439 \u043a\u0438\u043d\u0435\u043c\u0430\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0447\u0435\u0441\u043a\u0438\u0439 \u0441\u0432\u0435\u0442, \u0447\u0438\u0441\u0442\u044b\u0439 \u0431\u0435\u0436\u0435\u0432\u044b\u0439 \u0444\u043e\u043d, \u043b\u0451\u0433\u043a\u0438\u0435 \u0442\u0435\u043d\u0438, \u0440\u0435\u0430\u043b\u0438\u0441\u0442\u0438\u0447\u043d\u044b\u0435 \u043e\u0442\u0440\u0430\u0436\u0435\u043d\u0438\u044f \u0438 \u044d\u0441\u0442\u0435\u0442\u0438\u043a\u0430 \u043b\u044e\u043a\u0441\u043e\u0432\u043e\u0433\u043e \u0431\u0440\u0435\u043d\u0434\u0430.", "reference_audios": [], "reference_images": [], "reference_videos": [], "resolution": "720p"}),
  }
);

console.log(await response.json());

Пример ответа

Сразу после POST приходит объект с идентификатором задачи и статусом (queued или processing). Готовый результат — в поле outputs после завершения.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2026-05-22T12:00:00Z"
}

После успешного завершения:

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "outputs": [
    { "url": "https://storage.example/result.png", "type": "image" }
  ]
}

Поллинг

Пока задача в работе, опрашивайте GET https://api.flixa.io/v1/predictions/{id}/result с тем же API-ключом. Рекомендуемый интервал — 1–2 секунды; остановитесь при completed, failed или cancelled.

• queued / processing — продолжайте опрос.
• completed — заберите URL из outputs.
• failed — смотрите error в теле ответа.

curl "https://api.flixa.io/v1/predictions/{id}/result" \
  -H "Authorization: Bearer $FLIXA_API_KEY"