Séries Wan e HappyHorse

Os modelos de geração de vídeo da Alibaba, seis no total, chamados pelo endpoint de vídeo da OfoxAI POST /v1/videos. As tarefas são executadas de forma assíncrona: ao criar a tarefa, você recebe um ID e consulta o resultado com ele.

Escolha do modelo

Os seis suportam texto para vídeo e imagem para vídeo, e podem gerar uma faixa de áudio sincronizada (generate_audio tem padrão true). adaptive mantém a proporção da imagem de entrada.

A tabela acima corresponde ao video_attributes retornado pela Models API; se as capacidades de um modelo mudarem, prevalece o retorno da API. A cobrança é por segundo, e o custo real é o usage.video_cost no resultado da tarefa. Os preços estão na página do modelo .

Exemplos de chamada

Os exemplos abaixo mostram apenas a requisição de criação da tarefa. O fluxo completo de consulta de status e download do resultado está em Video API · Início rápido.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "Uma vila ribeirinha de Jiangnan ao amanhecer, com um pequeno barco passando devagar sob uma ponte de pedra",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-3.0",
    "prompt": "A pessoa da imagem se vira e caminha para longe",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/first.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "alibaba/wan-2.7",
    "prompt": "Mantenha o movimento de câmera e transforme a imagem em uma animação no estilo pintura a nanquim",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "video_url", "video_url": { "url": "https://example.com/source.mp4" } }
    ]
  }'

• frame_images e input_references não podem ser enviados juntos; enviar ambos retorna 400 references_conflict.
• Se não precisar de faixa de áudio, envie "generate_audio": false.
• A descrição completa da estrutura dos campos está em Criar tarefa de vídeo.

Diferenças em relação a outras séries

• Sem cancelamento: depois que a tarefa é enviada ao upstream, DELETE /v1/videos/{id} retorna 400 cancel_not_supported, e a tarefa continua sendo gerada e cobrada. Confira os parâmetros antes de enviar.
• Endereço do vídeo: nos testes, a tarefa concluída retorna apenas unsigned_urls (endereço temporário do Alibaba Cloud OSS), sem mirror_urls. O endereço temporário pode expirar após 24 horas; baixe e salve o arquivo o quanto antes.
• Durações mais curtas: o Wan começa em 2 segundos e o HappyHorse em 3 segundos; nas outras séries, o mínimo é 4 segundos.

Remover marca d’água

Parâmetros exclusivos dos modelos da Alibaba são enviados por provider.options.dashscope:

{
  "model": "alibaba/wan-3.0",
  "prompt": "...",
  "duration": 5,
  "resolution": "720p",
  "provider": {
    "options": { "dashscope": { "watermark": false } }
  }
}

provider.options só é repassado ao provedor correspondente; os demais provedores não o recebem. A descrição completa está em Roteamento de provedores de vídeo.

Erros comuns

Os códigos de erro completos estão em Códigos de erro da Video API.

Documentação oficial

• Alibaba Cloud Model Studio · Documentação dos serviços de modelo 
• OfoxAI · Criar tarefa de vídeo

Perguntas frequentes