Modelos de vídeo

Todos los modelos de vídeo de POST /v1/videos comparten la misma estructura de petición; se diferencian en las resoluciones, duraciones, relaciones de aspecto y modos de generación que aceptan. Estas capacidades de cada modelo se describen en el objeto video_attributes que devuelve la Models API. Esta página explica los campos de ese objeto y cómo consultarlo.

Los valores de los parámetros de cada modelo están en las páginas de familia: Seedance, Wan y HappyHorse y Hailuo.

El objeto `video_attributes`

Cada modelo de vídeo de la respuesta de la Models API incluye un objeto video_attributes, que es la descripción de referencia de los parámetros que acepta ese modelo.


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

Campo	Tipo	Descripción
`modes`	string[]	Modos de generación que admite el modelo: `t2v` texto a vídeo, `i2v` imagen a vídeo, `v2v` con vídeo como referencia. La petición no indica el modo: se deduce de los campos de material enviados; véase Determinación del modo
`resolutions`	string[]	Valores de `resolution` aceptados; cualquier valor fuera de la lista se rechaza
`default_resolution`	string	Valor que se aplica cuando la petición omite tanto `resolution` como `size`
`min_duration_seconds`	number	Límite inferior de `duration`, en segundos
`max_duration_seconds`	number	Límite superior de `duration`, en segundos
`supports_audio`	boolean	Indica si `generate_audio: true` genera una pista de audio
`aspect_ratios`	string[]	Valores de `aspect_ratio` aceptados; `adaptive` conserva la proporción de la imagen de entrada

video_attributes es la referencia fiable de cada modelo para resolution, duration y aspect_ratio. Los rangos de parámetros que figuran en Crear una tarea de vídeo son la unión de todos los modelos, por lo que un valor válido allí puede ser rechazado por un modelo concreto.

Consultar la lista en tiempo real

La Models API es un endpoint público y no requiere API Key. Filtre por supported_endpoints para quedarse solo con los modelos de vídeo:

cURL

Terminal


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

Python

video_models.py


import requests
 
models = requests.get("https://api.ofox.io/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"])

TypeScript

video-models.ts


const resp = await fetch('https://api.ofox.io/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)
}

Los nuevos modelos no se publican junto con la documentación; si necesita la lista más reciente, consulte directamente este endpoint.

Siguientes pasos

Familia Seedance Familia Wan y HappyHorse Familia Hailuo Crear una tarea de vídeo Enrutamiento de proveedores Resumen de Video API