Skip to Content
Référence APIGénération de vidéoModèles vidéo

Modèles vidéo

Tous les modèles vidéo de POST /v1/videos partagent la même structure de requête ; ils diffèrent par les résolutions, durées, formats d’image et modes de génération acceptés. Pour chaque modèle, ces capacités sont décrites par l’objet video_attributes renvoyé par la Models API. Cette page présente les champs de cet objet et la façon de l’interroger.

Les valeurs de paramètres de chaque modèle figurent dans les pages de famille : Seedance, Wan et HappyHorse, Hailuo.

L’objet video_attributes

Dans la réponse de la Models API, chaque modèle vidéo porte un objet video_attributes, qui fait autorité sur les paramètres acceptés par ce modèle.

{ "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"] }
ChampTypeDescription
modesstring[]Modes de génération pris en charge : t2v texte-vers-vidéo, i2v image-vers-vidéo, v2v vidéo de référence. Le mode n’est pas passé dans la requête : il est déduit des champs de média, voir Détermination du mode
resolutionsstring[]Valeurs de resolution acceptées ; toute valeur hors de la liste est rejetée
default_resolutionstringValeur appliquée lorsque la requête omet à la fois resolution et size
min_duration_secondsnumberBorne inférieure de duration, en secondes
max_duration_secondsnumberBorne supérieure de duration, en secondes
supports_audiobooleanIndique si generate_audio: true produit une piste audio
aspect_ratiosstring[]Valeurs de aspect_ratio acceptées ; adaptive reprend le format de l’image d’entrée

video_attributes fait foi, modèle par modèle, pour resolution, duration et aspect_ratio. Les plages de paramètres listées dans Créer une tâche vidéo sont l’union de tous les modèles : une valeur valide à cet endroit peut donc tout de même être rejetée par un modèle précis.

Interroger la liste en direct

La Models API est un endpoint public qui ne nécessite pas de clé API. Filtrez sur supported_endpoints pour ne conserver que les modèles vidéo :

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

La mise en service de nouveaux modèles ne suit pas les publications de la documentation ; pour obtenir la liste à jour, interrogez directement cet endpoint.

Suite

Dernière mise à jour le