Modelos de vídeo
Doze modelos são atendidos em POST /v1/videos. Todos aceitam o mesmo esquema de requisição — o que muda é a duração do clipe, o tamanho do frame, as proporções aceitas e o preço por segundo. Escolha um na matriz e passe o ID dele no campo model.
Matriz de recursos
| ID do modelo | Modos | Resoluções (padrão) | Duração | Proporções | A partir de $/s |
|---|---|---|---|---|---|
alibaba/happyhorse-1.0 | t2v · i2v · v2v | 720p 1080p (1080p) | 3–15 s | A | 0.13 |
alibaba/happyhorse-1.1 | t2v · i2v | 720p 1080p (1080p) | 3–15 s | A | 0.13 |
alibaba/wan-2.6 | t2v · i2v | 720p 1080p (1080p) | 2–15 s | A | 0.10 |
alibaba/wan-2.7 | t2v · i2v · v2v | 720p 1080p (1080p) | 2–15 s | A | 0.10 |
alibaba/wan-3.0 | t2v · i2v · v2v | 480p 720p 1080p (1080p) | 2–30 s | C | 0.054 |
alibaba/wan-3.0-prime | t2v · i2v · v2v | 480p 720p 1080p (1080p) | 2–30 s | C | 0.064 |
bytedance/seedance-2.0 | t2v · i2v · v2v | 480p 720p 1080p 4k (1080p) | 4–15 s | B | 0.07 |
bytedance/seedance-2.0-fast | t2v · i2v · v2v | 480p 720p (720p) | 4–15 s | B | 0.06 |
bytedance/seedance-2.0-mini | t2v · i2v · v2v | 480p 720p (720p) | 4–15 s | B | 0.04 |
bytedance/seedance-2.5 | t2v · i2v · v2v | 480p 720p 1080p (720p) | 4–30 s | D | 0.11 |
minimax/hailuo-3 | t2v · i2v · v2v | 768p 2k (768p) | 4–15 s | D | 0.08 |
minimax/hailuo-3-max | t2v · i2v · v2v | 480p 768p (768p) | 5–15 s | D | 0.05 |
Modos — t2v texto para vídeo, i2v imagem para vídeo, v2v vídeo para vídeo. Você nunca envia um modo; ele é inferido conforme a requisição traga frame_images ou input_references. Veja Modo de geração.
Conjuntos de proporções — cada conjunto contém o anterior:
| Conjunto | Valores |
|---|---|
| A | 16:9 9:16 1:1 |
| B | A + adaptive |
| C | B + 4:3 3:4 |
| D | C + 21:9 |
Áudio — os doze modelos geram uma trilha sonora sincronizada; generate_audio tem padrão true.
A partir de $/s é pricing.output_video_per_second — o nível mais barato do modelo, não o preço que você vai pagar. A tarifa cobrada é a entrada correspondente em pricing.video_pricing.tiers, que varia conforme resolução, tipo de entrada e áudio. Use usage.video_seconds e usage.video_cost da tarefa concluída como cobrança real. Veja Preço por segundo.
O objeto video_attributes
Todo modelo de vídeo na resposta da Models API traz um objeto video_attributes. Ele é a descrição autoritativa do que aquele modelo aceita — a matriz acima é apenas um retrato dele.
{
"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 que o modelo atende: t2v, i2v, v2v |
resolutions | string[] | Valores aceitos de resolution; qualquer coisa fora da lista é rejeitada |
default_resolution | string | 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 produz trilha sonora |
aspect_ratios | string[] | Valores aceitos de aspect_ratio; adaptive mantém a proporção da imagem de entrada |
video_attributes é a fonte da verdade de cada modelo para resolution, duration e aspect_ratio. As faixas de parâmetros em Criar vídeo abrangem todos os modelos de uma vez, então um valor listado lá ainda pode ser rejeitado por um modelo específico.
Consultar a lista ao vivo
A Models API é pública e não exige API Key. Filtre por supported_endpoints para manter apenas os modelos de vídeo:
cURL
curl -s https://api.ofox.ai/v1/models \
| jq -r '.data[] | select(.supported_endpoints[]? == "/v1/videos") | .id'Esta página é um retrato. Modelos entram no ar sem release de documentação, então consulte o endpoint sempre que a lista precisar estar atualizada.
Escolher por requisito
| Requisito | Modelos |
|---|---|
| 30 segundos em uma única tarefa | alibaba/wan-3.0, alibaba/wan-3.0-prime, bytedance/seedance-2.5 |
| Saída em 4K | bytedance/seedance-2.0 |
| Saída em 2K | minimax/hailuo-3 |
| Clipes com menos de 4 segundos | Todo modelo alibaba/* (piso de 2 s ou 3 s) |
| Vídeo para vídeo | Todo modelo exceto alibaba/happyhorse-1.1 e alibaba/wan-2.6 |
21:9 cinematográfico | bytedance/seedance-2.5, minimax/hailuo-3, minimax/hailuo-3-max |
| Tarifa inicial mais barata | bytedance/seedance-2.0-mini, a $0.04/s |