Skip to Content
Справочник APIГенерация видеоМодели видео

Видеомодели

Все видеомодели на POST /v1/videos используют одну и ту же структуру запроса и различаются допустимыми разрешениями, длительностью, соотношениями сторон и режимами генерации. Эти возможности каждой модели описывает объект video_attributes, который возвращает Models API; на этой странице описаны поля объекта и способ их получения.

Значения параметров для каждой модели приведены на страницах семейств: Seedance, Wan и HappyHorse, Hailuo.

Объект video_attributes

Каждая видеомодель в ответе Models API содержит объект video_attributes — авторитетное описание параметров, которые принимает модель.

{ "modes": ["t2v", "i2v", "v2v"], "resolutions": ["480p", "720p", "1080p"], "default_resolution": "720p", "min_duration_seconds": 4, "max_duration_seconds": 30, "supports_audio": true, "aspect_ratios": ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "adaptive"] }
ПолеТипОписание
modesstring[]Режимы генерации, которые поддерживает модель: t2v — текст в видео, i2v — изображение в видео, v2v — видео в качестве референса. Передавать режим в запросе не нужно: он определяется по полям с материалами, см. Определение режима
resolutionsstring[]Допустимые значения resolution; значения вне списка отклоняются
default_resolutionstringПрименяется, если в запросе нет ни resolution, ни size
min_duration_secondsnumberНижняя граница duration, в секундах
max_duration_secondsnumberВерхняя граница duration, в секундах
supports_audiobooleanСоздаёт ли generate_audio: true звуковую дорожку
aspect_ratiosstring[]Допустимые значения aspect_ratio; adaptive означает сохранение пропорций входного изображения

video_attributes — источник истины по resolution, duration и aspect_ratio для отдельной модели. Диапазоны параметров в разделе Создание задачи видео — это объединение по всем моделям, поэтому допустимое там значение всё равно может быть отклонено конкретной моделью.

Запрос актуального списка

Models API — публичный эндпоинт, API Key не требуется. Чтобы оставить только видеомодели, отфильтруйте по supported_endpoints:

Terminal
curl -s https://api.ofox.ai/v1/models \ | jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'

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

Далее

Обновлено