Modelos de vídeo

Todos os modelos de vídeo em POST /v1/videos compartilham a mesma estrutura de requisição; o que muda são as resoluções, durações, proporções e modos de geração aceitos. Essas capacidades de cada modelo são descritas pelo objeto video_attributes retornado pela Models API. Esta página explica os campos desse objeto e como consultá-lo.

Os valores de parâmetros de cada modelo estão nas páginas de série: Seedance, Wan e HappyHorse, Hailuo.

O objeto `video_attributes`

Todo modelo de vídeo na resposta da Models API traz um objeto video_attributes, que é a descrição oficial dos parâmetros aceitos pelo 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	Descrição
`modes`	string[]	Modos de geração suportados pelo modelo: `t2v` texto para vídeo, `i2v` imagem para vídeo, `v2v` vídeo como referência. O modo não é enviado na requisição; ele é inferido pelos campos de mídia. Veja Detecção de modo
`resolutions`	string[]	Valores aceitos de `resolution`; valores fora da lista são rejeitados
`default_resolution`	string	Valor aplicado quando a requisição omite tanto `resolution` quanto `size`
`min_duration_seconds`	number	Limite inferior de `duration`, em segundos
`max_duration_seconds`	number	Limite superior de `duration`, em segundos
`supports_audio`	boolean	Se `generate_audio: true` gera uma faixa de áudio
`aspect_ratios`	string[]	Valores aceitos de `aspect_ratio`; `adaptive` mantém a proporção da imagem de entrada

video_attributes é a referência factual de cada modelo para resolution, duration e aspect_ratio. As faixas de parâmetros listadas em Criar tarefa de vídeo são a união de todos os modelos, portanto um valor válido ali ainda pode ser rejeitado por um modelo específico.

Consultar a lista ao vivo

A Models API é um endpoint público e não exige API key. Filtre por supported_endpoints para manter apenas os modelos de vídeo:

cURL

Terminal


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

Python

video_models.py


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"])

TypeScript

video-models.ts


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)
}

Novos modelos entram no ar sem acompanhar uma publicação da documentação; quando precisar da lista mais recente, consulte esse endpoint diretamente.

Próximos passos

Série Seedance Séries Wan e HappyHorse Série Hailuo Criar tarefa de vídeo Roteamento de provedores Visão geral da Video API