Modèles vidéo

Douze modèles sont servis sur POST /v1/videos. Ils acceptent tous le même schéma de requête — ce qui change, c’est la durée du clip, la taille d’image, les formats acceptés et le prix à la seconde. Choisissez-en un dans la matrice, puis passez son ID dans le champ model.

Matrice des capacités

Modes — t2v texte-vers-vidéo, i2v image-vers-vidéo, v2v vidéo-vers-vidéo. Vous n’envoyez jamais de mode : il est déduit selon que la requête porte frame_images ou input_references. Voir Mode de génération.

Jeux de formats — chaque jeu contient le précédent :

Audio — les douze modèles produisent une bande-son synchronisée ; generate_audio vaut true par défaut.

L’objet video_attributes

Chaque modèle vidéo de la réponse de la Models API porte un objet video_attributes. C’est la description faisant autorité de ce que ce modèle accepte — la matrice ci-dessus n’en est qu’un instantané.

{
  "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"]
}

Interroger la liste en direct

La Models API est publique et ne nécessite pas de clé API. Filtrez sur supported_endpoints pour ne garder que les modèles vidéo :

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

import requests
 
models = requests.get("https://api.ofox.ai/v1/models").json()["data"]
 
for m in models:
    if "/v1/videos" in m.get("supported_endpoints", []):
        va = m["video_attributes"]
        print(m["id"], va["modes"], va["resolutions"], va["max_duration_seconds"])

const resp = await fetch('https://api.ofox.ai/v1/models')
const { data } = await resp.json()
 
for (const m of data) {
  if (!m.supported_endpoints?.includes('/v1/videos')) continue
  const va = m.video_attributes
  console.log(m.id, va.modes, va.resolutions, va.max_duration_seconds)
}

Choisir selon le besoin

Suite