APIMaster.ai

Vidu Video Q4 Preview · Referência da API

Gerar um vídeo a partir de uma única imagem ou referências, em seguida, enquete a tarefa APIMaster.

Use POST /v1/wand/vidu/image-to-video para uma única imagem inicial ou POST /v1/wand/vidu/reference-to-video para geração guiada por referência. Pesquisa com GET /v1/wand/vidu/tasks/{task_id}. Use JSON para submissão e autenticação Bearer para cada solicitação. Geração somente texto e um ponto final separado de start/end-frame não estão disponíveis para este modelo.

Campo Tipo Descrição
model string Obrigatório. Use vidu-video-q4-preview.
images string[] Image-to-video requer exatamente uma imagem. Reference-to-video aceita até imagens 15 ou subjects. Use URIs públicos URLs ou dados em PNG, JPEG/JPG ou WebP. A relação de aspecto deve ser 1:4 para 4:1. Cada imagem URL pode ser de até 50 MB. As imagens Base64 são limitadas a 15 MB antes da codificação e 20 MB codificadas no total.
subjects object[] Para reference-to-video como alternativa ao images. Defina o name de cada item e um a três images. Refira um assunto com @name no prompt.
prompt string Necessário para reference-to-video. Até caracteres 2,000 para referências diretas de imagem ou 5,000 para assuntos e image-to-video. Image-to-video ignora este campo quando is_rec está ligado.
auto_subjects boolean Opção de biblioteca de assunto para reference-to-video. Valor padrão: false.
audio boolean O padrão é true para image-to-video e false para reference-to-video. A referência de vídeo com áudio requer subjects e um valor explícito de true.
audio_type string Quando o áudio estiver ativado, use all (padrão), speech_only ou sound_effect_only.
is_rec boolean Recomendação rápida automática para image-to-video. Habilitá-lo aumenta o uso da tarefa.
duration integer De 3 a 16 segundos, com 5 como padrão.
resolution string 540p, 720p (padrão), 1080p, 2K, ou 4K.
aspect_ratio string Reference-to-video apenas. Use 16:9 (padrão), 9:16, 3:4, 4:3 ou 1:1. Image-to-video segue a imagem de entrada.
seed integer Omita o campo ou use 0 para escolher uma semente aleatória.
payload string Dados de aplicação opcionais, até caracteres 1,048,576.
watermark boolean Valor padrão: false.
wm_url string Marca d'água personalizada opcional URL. A marca d'água padrão aparece no canto superior esquerdo. A API não aceita wm_position.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

Consulte o status a cada 5–10 segundos com o task_id e a mesma conta. Os estados são created, queueing, processing, success e failed. No sucesso, creations[].url é o vídeo e creations[].cover_url é sua capa. Faça o download de links temporários dentro de horas 12. Mantenha request_id ao relatar uma falha.

Use um Idempotency-Key de caracteres 8–128 visíveis ASCII para recuperar uma submissão. A mesma chave com os mesmos parâmetros retorna um recibo de recuperação com HTTP 202. Parâmetros diferentes com a mesma chave retornam HTTP 409. Ver Guia de recuperação de solicitações. Os timeouts de consulta podem ser tentados sem criar um novo vídeo.

O portal resolve a geração uma vez. tokenhub_usage.total_tokens relata o uso faturável. Veja o modelo ZVidu Video Q4 Preview cartão para o preço atual APIMaster.