Skip to Content
APIGeração de vídeoModelos de vídeo

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 modeloModosResoluções (padrão)DuraçãoProporçõesA partir de $/s
alibaba/happyhorse-1.0t2v · i2v · v2v720p 1080p (1080p)3–15 sA0.13
alibaba/happyhorse-1.1t2v · i2v720p 1080p (1080p)3–15 sA0.13
alibaba/wan-2.6t2v · i2v720p 1080p (1080p)2–15 sA0.10
alibaba/wan-2.7t2v · i2v · v2v720p 1080p (1080p)2–15 sA0.10
alibaba/wan-3.0t2v · i2v · v2v480p 720p 1080p (1080p)2–30 sC0.054
alibaba/wan-3.0-primet2v · i2v · v2v480p 720p 1080p (1080p)2–30 sC0.064
bytedance/seedance-2.0t2v · i2v · v2v480p 720p 1080p 4k (1080p)4–15 sB0.07
bytedance/seedance-2.0-fastt2v · i2v · v2v480p 720p (720p)4–15 sB0.06
bytedance/seedance-2.0-minit2v · i2v · v2v480p 720p (720p)4–15 sB0.04
bytedance/seedance-2.5t2v · i2v · v2v480p 720p 1080p (720p)4–30 sD0.11
minimax/hailuo-3t2v · i2v · v2v768p 2k (768p)4–15 sD0.08
minimax/hailuo-3-maxt2v · i2v · v2v480p 768p (768p)5–15 sD0.05

Modost2v 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:

ConjuntoValores
A16:9 9:16 1:1
BA + adaptive
CB + 4:3 3:4
DC + 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"] }
CampoTipoDescrição
modesstring[]Modos de geração que o modelo atende: t2v, i2v, v2v
resolutionsstring[]Valores aceitos de resolution; qualquer coisa fora da lista é rejeitada
default_resolutionstringAplicado quando a requisição omite tanto resolution quanto size
min_duration_secondsnumberLimite inferior de duration, em segundos
max_duration_secondsnumberLimite superior de duration, em segundos
supports_audiobooleanSe generate_audio: true produz trilha sonora
aspect_ratiosstring[]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:

Terminal
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

RequisitoModelos
30 segundos em uma única tarefaalibaba/wan-3.0, alibaba/wan-3.0-prime, bytedance/seedance-2.5
Saída em 4Kbytedance/seedance-2.0
Saída em 2Kminimax/hailuo-3
Clipes com menos de 4 segundosTodo modelo alibaba/* (piso de 2 s ou 3 s)
Vídeo para vídeoTodo modelo exceto alibaba/happyhorse-1.1 e alibaba/wan-2.6
21:9 cinematográficobytedance/seedance-2.5, minimax/hailuo-3, minimax/hailuo-3-max
Tarifa inicial mais baratabytedance/seedance-2.0-mini, a $0.04/s

Próximos passos

Last updated on