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.
