SD Cloud Edition Video API

На этой странице описан вызов видеомоделей SD (облачная версия; SD2.0 и SD2.5). Как и другие видеомодели, они создаются через POST /v1/videos и опрашиваются через GET /v1/videos/{id}; аутентификация, загрузка материалов, статусы опроса, скачивание результатов и обработка ошибок описаны в полной спецификации Video API. Здесь приведены только поля и правила, специфичные для этой группы моделей.

Обновлено 2026-10-10. Эта группа моделей поддерживает только опрос: не указывайте callback_url при создании, иначе запрос будет отклонён. SD (облачная версия) — отдельная группа моделей, не совпадающая с Seedance (официальная версия) и Seedance (официальная ретрансляция); параметры и возможности у них не взаимозаменяемы.

Модели

У каждой серии одно название модели; выходное разрешение выбирается полем resolution, и тарификация идёт по выбранному уровню, например "model": "SD2.5", "resolution": "720p" или "model": "SD2.0", "resolution": "4k".

Общие правила

• Разрешение: укажите в resolution уровень из таблицы выше, регистр не важен (4k и 4K равнозначны); без него используется минимальный уровень 480p. Неподдерживаемый серией уровень вернёт 400 без автоматического понижения.
• Длительность: целое число секунд в duration (или строкой в seconds); по умолчанию 5 секунд.
• Соотношение сторон: ratio (или aspect_ratio) принимает 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.
  • SD2.5: соотношение сторон обязательно указывать явно, auto не поддерживается; без него или с auto вернётся 400.
  • SD2.0: по умолчанию 1:1.
• Промпт:
  • SD2.5: prompt обязателен.
  • SD2.0: при наличии референсных материалов или первого и последнего кадра его можно опустить, но рекомендуется описать движение и камеру.
• Генерация звука: SD2.5 поддерживает generate_audio (boolean); у SD2.0 такого переключателя нет, его передача вернёт 400.
• Необязательные поля: negative_prompt (негативный промпт), seed (целое число).

Референсные материалы

• Референсные изображения передаются в массиве верхнего уровня images.
• Референсные видео передаются в metadata.referenceVideos, референсное аудио — в metadata.referenceAudios.
• SD2.0 принимает не более 12 материалов всех типов в сумме.
• Для SD2.5 каждое референсное видео длится от 2 до 30 секунд, а суммарная длительность всех референсных видео — не более 30 секунд.
• Для каждого типа материалов используйте одно поле; если передано несколько псевдонимов, будет использован один набор без объединения.

{
  "model": "SD2.5",
  "resolution": "1080p",
  "prompt": "Сохранить лицо и одежду персонажа с изображения, он бежит по дождливой ночной улице с движением камеры из видео",
  "duration": 10,
  "ratio": "9:16",
  "generate_audio": true,
  "images": ["https://cdn.example.com/character.jpg"],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/camera-motion.mp4"]
  }
}

Первый и последний кадр

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

{
  "model": "SD2.0",
  "resolution": "720p",
  "prompt": "Камера переходит от побережья на рассвете к той же бухте на закате",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Загрузка файлов

Одно локальное изображение можно также передать напрямую через multipart/form-data в поле input_reference; в этом случае не передавайте в том же запросе images или image. Референсные видео и аудио нельзя передать файлом: сначала получите URL, как описано в разделе Загрузка локальных файлов.

Устаревшие названия моделей

Прежние названия с суффиксом уровня (например, SD2.5 720P, SD2.0 4K) по-прежнему работают, но вывод и тарификация закреплены за уровнем из названия, а resolution игнорируется. Они больше не отображаются в каталоге моделей; для новых интеграций используйте SD2.5 или SD2.0 вместе с resolution.