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 img_uuid retornado ou receba callbacks de status.
Obter Chave de API
Cena cinematográfica à beira do lago representando a consistência de referência para vídeo

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.
Maquetes de personagens sem marca organizadas juntas para referência visual

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.
Equipamento de câmera cinematográfica representando um fluxo de produção assíncrono
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 model como viduq3_reference 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 image_urls. 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 image_urls, não image_url ou image_end_url. Use viduq3_pro 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 540p, 720p ou 1080p. O padrão documentado é 720p.

Proporção de saída

Defina ratio como 16:9, 9:16 ou 1:1; o padrão documentado é 16:9. aspect_ratio é 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.
Obter chave de API
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.

Perguntas frequentes sobre a API Vidu Q3 Reference

Qual é o endpoint da API de Referência Vidu Q3 no GoEnhance?

Envie um POST https://api.goenhance.ai/api/v1/videos/generations com model definido como viduq3_reference. Um envio bem-sucedido retorna img_uuid para rastreamento assíncrono.

Como funciona a precificação da API de Referência Vidu Q3?

A precificação é por segundo gerado: 1,75 tokens/s ($0.035/s) a 540p, 3 tokens/s ($0.06/s) a 720p e 3,75 tokens/s ($0.075/s) a 1080p. Multiplique a taxa selecionada pela duração.

Quantas imagens de referência posso enviar?

A matriz image_urls documentada requer de 1 a 7 imagens. Cada uma deve atender aos limites publicados de formato, tamanho, dimensão e proporção.

Posso enviar image_url ou image_end_url?

Não. Esta rota de referência dedicada aceita image_urls. Use a rota viduq3_pro documentada separadamente para texto para vídeo, imagem para vídeo de primeiro quadro ou geração de quadro inicial-final.

Quais valores de duração, resolução e proporção são suportados?

A duração é de 3 a 16 segundos. A resolução suporta 540p, 720p e 1080p. A proporção suporta 16:9, 9:16 e 1:1.

Como sei quando o vídeo está pronto?

Mantenha o img_uuid e consulte GET /api/v1/jobs/detail, ou forneça uma custom_callback_url HTTPS pública. Respostas de retorno de chamada que não sejam 200 são tentadas novamente até três vezes, com um tempo limite de três segundos por tentativa.

Esta é a API oficial da ShengShu?

Não. O Vidu é desenvolvido pela ShengShu Technology. Esta página descreve o acesso independente de API de terceiros através do GoEnhance e não implica afiliação, parceria ou endosso.

Qual é a diferença entre o Vidu Q3 Reference e o nível de referência Turbo?

Esta página cobre a rota padrão viduq3_reference. A rota viduq3_turbo_reference, documentada separadamente, é o nível de referência mais rápido e de menor preço; não misture seu identificador de modelo ou preço nesta solicitação.

Comece a desenvolver com a API Vidu Q3 Reference