img_uuid retornado ou receba callbacks de status.API Vidu Q3 Reference para Vídeo Consistente
Acesse a Vidu Q3 Reference através da API aberta da GoEnhance. Forneça de 1 a 7 imagens de referência com um prompt, envie uma tarefa de vídeo assíncrona e, em seguida, faça o polling com o
Obter Chave de API
Construir uma solicitação da API Vidu Q3 Reference
Entrada de imagem de referência criada para consistência
Faça um POST para https://api.goenhance.ai/api/v1/videos/generations com model: viduq3_reference, um prompt obrigatório e image_urls contendo de 1 a 7 imagens de referência públicas.
Solicitações validadas e resultados assíncronos
Valide o formato, dimensões, proporção, duração, resolução e proporção de saída da imagem antes do envio. Persista o img_uuid, depois faça o polling em GET /api/v1/jobs/detail ou use um callback HTTPS público.
Corresponda ao esquema de solicitação de referência para vídeo documentado antes de enviar uma tarefa.
Capacidades e limites da API Vidu Q3 Reference
Modelo e prompt
Defina <code>model</code> como <code>viduq3_reference</code> e forneça o prompt de texto obrigatório descrevendo o vídeo pretendido.
Imagens de referência
Envie de 1 a 7 URLs em <code>image_urls</code>. Cada imagem deve ser PNG, JPEG, JPG ou WebP; pelo menos 128x128 pixels; não maior que 50 MB; e entre a proporção de 1:4 e 4:1.
Modo de entrada dedicado
Esta rota aceita <code>image_urls</code>, não <code>image_url</code> ou <code>image_end_url</code>. Use <code>viduq3_pro</code> para geração apenas de texto, primeiro quadro ou quadro inicial-final.
Duração
Escolha um número inteiro de 3 a 16 segundos. O padrão documentado é 5 segundos.
Resolução
Selecione <code>540p</code>, <code>720p</code> ou <code>1080p</code>. O padrão documentado é <code>720p</code>.
Proporção de saída
Defina <code>ratio</code> como <code>16:9</code>, <code>9:16</code> ou <code>1:1</code>; o padrão documentado é <code>16:9</code>. <code>aspect_ratio</code> é aceito como um alias compatível.
Estime o custo como a taxa por segundo selecionada multiplicada pela duração solicitada.
Preços da API de Referência Vidu Q3
540p
1,75 tokens por segundo gerado, equivalente a $0.035 por segundo à taxa documentada de $0.02 por token.
720p
3 tokens por segundo gerado, equivalente a $0.06 por segundo à taxa documentada de $0.02 por token.
1080p
3,75 tokens por segundo gerado, equivalente a $0.075 por segundo à taxa documentada de $0.02 por token.
Integre a Referência Vidu Q3 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 compatíveis em URLs públicas e decida quais detalhes visuais o prompt deve preservar.
3
3. Valide a solicitação
Defina
viduq3_reference, uma duração de 3 a 16 segundos, uma resolução suportada e uma proporção suportada. 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 configure uma custom_callback_url HTTPS pública. 6
6. Lide com a conclusão
Processe estados de sucesso e falha de forma idempotente e, em seguida, verifique o ativo gerado antes do uso posterior.
Construa fluxos de trabalho de referência para vídeo repetíveis em torno de entradas explícitas e estados de tarefa terminais.
Casos de uso do desenvolvedor para a API de Referência Vidu Q3
Clipes de campanha liderados por personagens
Leve personagens fictícios aprovados ou referências de talentos para conceitos de vídeos de campanha curtos.
Sequências de identidade de produto
Use múltiplas visualizações de produto aprovadas como referências visuais para exploração criativa focada em movimento.
Continuidade de história
Referencie assuntos recorrentes ao gerar tomadas separadas para fluxos de trabalho de storyboard e pré-visualização.
Variantes criativas localizadas
Reutilize referências visuais aprovadas enquanto adapta prompts para conceitos de campanha regionais.
Ativos sociais com estilo consistente
Construa pipelines de vídeo de formato curto em torno de um conjunto controlado de referências visuais e proporções de saída.
Prototipagem criativa
Teste combinações de referência, prompts, durações e resoluções antes de se comprometer com um fluxo de trabalho de produção mais amplo.
Respostas para perguntas comuns sobre preços, entrada de referência, tarefas assíncronas e a API ShengShu.