img_uuid retornado e faça polling ou use um callback para receber o vídeo gerado.API Vidu Q3 Turbo Reference para Assuntos de Vídeo Consistentes
Acesse a API Vidu Q3 Turbo Reference através da API aberta independente da GoEnhance. Envie de 1 a 7 imagens de referência com um prompt, preserve o
Obter Chave de API
Crie uma solicitação válida de referência para vídeo
Forneça de 1 a 7 imagens de referência
Faça um POST para https://api.goenhance.ai/api/v1/videos/generations com model: viduq3_turbo_reference, um prompt obrigatório e uma matriz image_urls contendo de 1 a 7 URLs de imagens públicas.
Acompanhe cada tarefa assíncrona
Escolha uma duração de 1 a 16 segundos e uma resolução de 540p, 720p ou 1080p. Salve o img_uuid retornado, depois faça polling em GET /api/v1/jobs/detail ou configure uma custom_callback_url.
Valide o contrato apenas de referência antes de enviar uma tarefa de produção.
Capacidades e parâmetros da API Vidu Q3 Turbo Reference
ID exato do modelo
Defina <code>model</code> como <code>viduq3_turbo_reference</code>; preserve o sublinhado exatamente.
Prompt obrigatório
Descreva a ação pretendida, o cenário, o comportamento da câmera e o tratamento visual no <code>prompt</code>.
Matriz de referência
Forneça de 1 a 7 URLs de imagens públicas através de <code>image_urls</code>.
Rota apenas de referência
Não envie <code>image_url</code> ou <code>image_end_url</code>; use <code>viduq3_turbo</code> para esses modos.
Duração
Escolha um número inteiro de 1 a 16 segundos. O padrão documentado é 5 segundos.
Resolução
Use <code>540p</code>, <code>720p</code> ou <code>1080p</code>; o padrão documentado é <code>720p</code>.
Estime o custo total como a taxa por segundo selecionada multiplicada pela duração solicitada.
Preços da API de Referência Vidu Q3 Turbo
540p
1 token por segundo gerado, equivalente a $0.02 por segundo à taxa documentada de $0.02 por token.
720p
2,5 tokens por segundo gerado, equivalente a $0.05 por segundo à taxa documentada de $0.02 por token.
1080p
3,25 tokens por segundo gerado, equivalente a $0.065 por segundo à taxa documentada de $0.02 por token.
Integre a API de Referência Vidu Q3 Turbo em seis etapas
1
1. Crie uma chave de API
Crie uma chave GoEnhance e envie-a como um token bearer no cabeçalho de Autorização.
2
2. Prepare as referências
Hospede de 1 a 7 imagens de referência aprovadas em URLs públicos que sua solicitação possa fornecer em
image_urls. 3
3. Valide o payload
Defina o ID do modelo exato, o prompt, a duração e uma resolução documentada; omita os campos exclusivos do primeiro quadro.
4
4. Envie a tarefa
Faça um POST para
/api/v1/videos/generations e persista o img_uuid retornado. 5
5. Acompanhe o status
Consulte
GET /api/v1/jobs/detail ou forneça uma URL de retorno de chamada HTTPS pública. 6
6. Gerencie a conclusão
Processe o sucesso ou falha terminal de forma idempotente e verifique o vídeo retornado antes do uso posterior.
Crie pipelines repetíveis onde entradas visuais aprovadas guiam uma cena gerada.
Casos de uso de desenvolvedor para vídeo orientado por referência
Continuidade de personagem
Use várias visualizações de personagem aprovadas para guiar assuntos recorrentes em clipes gerados curtos.
Storytelling de produto
Forneça referências de produto e um prompt de cena para conceitos de campanha revisáveis.
Variantes de campanha
Reutilize um conjunto de referência visual aprovado enquanto altera os prompts para diferentes posicionamentos ou batidas de história.
Previsualização
Transforme referências de personagem, objetos e ambiente em conceitos de movimento antes da produção completa.
Criativo localizado
Parametrize prompts de cena mantendo as mesmas referências visuais aprovadas em variantes regionais.
Conteúdo serializado
Guie assuntos recorrentes e direção de arte em tarefas assíncronas enviadas independentemente.
Respostas para perguntas comuns sobre entrada, preços, status de tarefas e a API da ShengShu.