aspectRatiostring
Соотношение сторон: "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "auto", "adaptive" (зависит от модели). Если параметр не указан, по умолчанию используется "auto".
durationinteger
Длительность видео в секундах. Модели seedance-2-0 и happyhorse-1.0 в настоящее время принимают ~3–15 секунд (любое целое число в этом диапазоне). Модель veo-3.1 принимает ровно 4, 6 или 8 секунд (по умолчанию 4) — другие значения будут отклонены. По умолчанию используется стандартная длительность модели. Вызовите list_models, чтобы узнать текущие допустимые значения для каждой модели.
firstFramestring
Изображение первого кадра для управления началом видео. Принимает публичный URL или локальный путь к файлу (автоматически загружается). ОБЯЗАТЕЛЬНО для grok-video (только image-to-video - бэкенд отклоняет запрос без firstFrame). Для seedance/happyhorse/veo это необязательно: без первого кадра они выполняют чистый text-to-video.
lastFramestring
Дополнительное изображение последнего кадра, которое также управляет тем, где заканчивается видео. Используется в seedance-2-0 и veo-3.1; happyhorse-1.0 игнорирует это поле. Принимает публичный URL или локальный путь к файлу. Требует, чтобы параметр firstFrame также был указан — передача только lastFrame отклоняется.
modelstringобязательный
Идентификатор видеомодели. Используйте list_models, чтобы просмотреть доступные видеомодели. Распространённые (на момент написания): "seedance-2-0" (многоуровневая модель общего назначения), "happyhorse-1.0" (экономичная i2v/t2v), "veo-3.1" (Google Veo с двумя уровнями, 4/6/8 секунд, встроенный звук), "grok-video" (xAI Grok Imagine 1.5 — ТОЛЬКО ИЗОБРАЖЕНИЕ-В-ВИДЕО: первый кадр ОБЯЗАТЕЛЕН, чистое текст-в-видео отклоняется; встроенный звук; 4–15 секунд; 480p/720p).
promptstringобязательный
Промпт для генерации видео. Опиши движение, сцену и стиль — а не только статичное изображение.
referenceVideostring
Необязательный URL опорного видео для Seedance 2.0 «продолжение видео». Должен быть публично доступным HTTPS-URL (обычно это результат предыдущей генерации videoUrl); локальные пути не поддерживаются. Только seedance-2-0 принимает этот параметр, передача его другим моделям приведёт к ошибке.
ВАЖНО: требование к промпту. Чтобы новый клип семантически продолжал опорное видео, prompt ОБЯЗАН явно содержать «extend» / «continue» (например, начинаться с «Extend this video with the following plot:»). Без этого модель воспринимает видео только как визуальную ссылку, и новый клип может отклониться от настоящего продолжения.
Вывод: на выходе будет ТОЛЬКО duration секунд (4-15с) нового контента, опорное видео НЕ добавляется к результату. Чтобы получить единый клип «оригинал + новое», пользователю придётся склеить их локально.
Тарификация: кредиты списываются по тарифу «с опорным видео», при этом billable_seconds = max(reference_duration + duration, min_billable[duration]). Итоговая стоимость часто выше, чем при прямой генерации той же длины. Всегда передавайте referenceVideoDuration вместе с этим полем, пропуск приведёт к заниженному списанию кредитов и сломанному поведению продолжения.
referenceVideoDurationinteger
Длительность эталонного видео в секундах (обычно 2–15, бэкенд проверяет допустимый диапазон). Обязательно, если задан referenceVideo; если не задан, бэкенд считает его равным 0, что недоначисляет кредиты и делает генерацию некорректной. Передайте фактическую длительность клипа в referenceVideo.
resolutionstring
Разрешение вывода. Обычно: "480p" / "720p" / "1080p" / "4k" (зависит от модели; например, Seedance Pro добавляет 1080p и 4k, а Fast/Mini - только 480p/720p). Используйте list_models, чтобы узнать, что поддерживает каждая модель. Более высокое разрешение стоит больше кредитов в секунду.
tierstring
Уровень качества — только для моделей, поддерживающих уровни. seedance-2-0 принимает «mini» (базовый, самый дешёвый; 480p/720p, без референсного видео), «fast» (480p/720p) или «pro» (наивысшее качество; нативное 1080p и 4K); veo-3.1 принимает «fast» (базовый) или «pro». Уровни могут добавляться платформой — вызовите list_models, чтобы узнать, что поддерживает каждая модель.
