img_uuid retornado e, em seguida, faça polling ou receba callbacks até que o trabalho seja concluído ou falhe.API Vidu Q3 Pro para Geração de Vídeo
Acesse o Vidu Q3 Pro através da API aberta e independente da GoEnhance para geração de texto para vídeo, imagem para vídeo e geração com quadro inicial e final. Envie uma solicitação assíncrona, armazene o
Obter Chave de API
Crie uma solicitação de API Vidu Q3 Pro clara
Três modos de entrada em um único endpoint
Faça um POST para https://api.goenhance.ai/api/v1/videos/generations com model: viduq3_pro. Use apenas um prompt para texto para vídeo, adicione image_url para um quadro inicial ou adicione image_end_url para geração com quadro inicial e final.
Controles explícitos e conclusão assíncrona
Valide a duração, resolução e proporção de texto para vídeo antes do envio. Salve o ID da tarefa retornado e, em seguida, use GET /api/v1/jobs/detail ou uma custom_callback_url HTTPS pública para lidar com os resultados finais.
Corresponda ao esquema de solicitação documentado antes que uma tarefa entre no seu pipeline de vídeo.
Recursos e parâmetros da API Vidu Q3 Pro
Modelo
Defina <code>model</code> como <code>viduq3_pro</code>.
Prompt
Forneça o prompt de texto necessário descrevendo o vídeo pretendido.
Quadro inicial
Adicione uma <code>image_url</code> pública para geração de imagem para vídeo; omita-a para texto para vídeo.
Quadro final
Adicione <code>image_end_url</code> juntamente com <code>image_url</code> para controle de quadro inicial e final.
Duração
Escolha um número inteiro de 1 a 16 segundos. O padrão documentado é de 5 segundos.
Resolução e proporção
A resolução aceita 540p, 720p ou 1080p, com padrão de 720p. O campo <code>ratio</code> aplica-se a solicitações de texto para vídeo.
Estime o custo de geração como a taxa selecionada por segundo multiplicada pela duração solicitada.
Preços da API Vidu Q3 Pro
540p
2,25 tokens por segundo gerado, equivalente a $0.045 por segundo à taxa documentada de $0.02 por token.
720p
5 tokens por segundo gerado, equivalente a $0.10 por segundo à taxa documentada de $0.02 por token.
1080p
6 tokens por segundo gerado, equivalente a $0.12 por segundo à taxa documentada de $0.02 por token.
Integre o Vidu Q3 Pro 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. Selecione o modo de entrada
Use apenas um prompt, adicione uma URL de primeiro quadro ou adicione URLs de primeiro e último quadro.
3
3. Valide a solicitação
Defina
viduq3_pro, uma duração de 1 a 16 segundos e um dos valores de resolução documentados. 4
4. Envie a tarefa de vídeo
Faça um POST para
/api/v1/videos/generations e persista o img_uuid retornado. 5
5. Acompanhe o status
Faça polling em
GET /api/v1/jobs/detail ou configure uma URL de callback HTTPS pública. 6
6. Gerencie a conclusão
Processe estados de sucesso e falha de forma idempotente e verifique o ativo retornado antes do uso posterior.
Crie fluxos de trabalho de geração de vídeo repetíveis em torno de entradas explícitas e estados de tarefa terminais.
Casos de uso do desenvolvedor para a API Vidu Q3 Pro
Variantes de vídeo de campanha
Gere clipes conceituais curtos a partir de prompts estruturados para revisão criativa e montagem posterior.
Movimento de produto
Anime um quadro de produto aprovado enquanto seu aplicativo controla prompts, validação e revisão de ativos.
Transições de storyboard
Use entradas de primeiro e último quadro para explorar o movimento entre dois batimentos visuais aprovados.
Pipelines criativos localizados
Parametrize prompts para variantes de campanha regionais sem alterar o manipulador de tarefas assíncronas.
Produção de vídeo para redes sociais
Crie ativos de movimento breves em uma resolução e duração selecionadas pelo seu aplicativo.
Pré-visualização
Transforme descrições concisas de cenas em conceitos de movimento revisáveis antes da produção completa.
Respostas para perguntas comuns sobre preços, entradas, status de tarefas e a API de vídeo da ShengShu.