Vidu MoE vs Q3 Pro vs Q3 Turbo: qual escolher

Se eu tivesse que resumir em uma linha: use o Vidu MoE para lógica de prompt mais difícil, use o Q3 Pro para a saída final e use o Q3 Turbo para testes de menor custo, tudo em uma única APIMart.

Aqui está a versão resumida que você pode aplicar já:

• Eu consigo acessar Vidu MoE, Vidu Q3 Pro e Vidu Q3 Turbo pela APIMart com uma chave de API e um fluxo principal de requisição.
• O endpoint central é POST https://api.apimart.ai/v1/videos/generations.
• Os jobs de vídeo são assíncronos, então recebo um task_id primeiro e depois faço polling de GET /v1/tasks/{task_id} até o job ficar completed.
• O Vidu suporta:
  • texto-para-vídeo
  • imagem-para-vídeo
  • vídeo baseado em referência
  • transições de primeiro-último quadro
• Os modelos Q3 adicionam áudio integrado como diálogo, efeitos sonoros e música.
• Os clipes podem durar até 16 segundos, com saída em 540p, 720p ou 1080p.
• O preço da APIMart no artigo lista:
  • Q3 Pro: cerca de $0.12/seg em 720p
  • Q3 Turbo: cerca de $0.048/seg em 720p
• A APIMart guarda os resultados por 72 horas, então devo baixar os arquivos logo depois que a tarefa terminar.

Principais pontos

• Na APIMart, a opção premium da Vidu é o Vidu Q3 Mix (viduq3-mix), um modelo de referência-para-vídeo com qualidade premium, transições inteligentes mais fortes e clipes a partir de 1 segundo; a documentação da APIMart não o descreve como um modelo Mixture of Experts (documentação).
• O Vidu Q3 Pro (viduq3-pro) é voltado ao resultado cinematográfico final, com 1080p e áudio sincronizado, enquanto o Vidu Q3 Turbo (viduq3-turbo) prioriza custo menor, baixa latência e iteração rápida.
• Na APIMart, em 720p, o Q3 Pro custa cerca de US$ 0,12/s e o Q3 Turbo cerca de US$ 0,048/s, e os modelos Q3 geram clipes de até 16 segundos em 540p, 720p ou 1080p.
• Os três modelos usam uma única chave da APIMart e o fluxo assíncrono POST https://api.apimart.ai/v1/videos/generations, que retorna um task_id para consulta via GET /v1/tasks/{task_id}.
• Comece os rascunhos no Q3 Turbo, leve a renderização final em 1080p para o Q3 Pro, mantenha clipes de 5–10 segundos para fidelidade de movimento e baixe os resultados em até 72 horas, enquanto a APIMart ainda os guarda.

Comparação rápida

O que se destaca para mim é o quão simples é a troca: na maioria dos casos, eu só mudo o campo model e mantenho o resto da configuração igual. Isso faz o artigo ser menos sobre trabalho de configuração e mais sobre escolher o modelo certo para custo, tempo de espera e qualidade de saída.

Modelos Vidu explicados: MoE vs. série Q

O modelo MoE do Vidu: o que é e quando usá-lo

O modelo MoE (Mixture of Experts) envia diferentes partes de uma tarefa de geração para especialistas dedicados a movimento, consistência de cena e controle de prompt. Ele faz mais sentido para prompts multi-cena ou mais longos, onde a consistência importa mais do que a velocidade pura.

Há uma ressalva, porém. O MoE exige mais computação e tem entrega mais lenta que a série Q ^[7]. Para prompts simples, ele costuma ser mais do que você precisa.

Série Q do Vidu e Vidu Q3 Pro: desempenho para uso em produção

Se o MoE é o especialista, a série Q é a opção feita para trabalho de produção. O Vidu Q3 Pro foi projetado para saída cinematográfica refinada e vídeos guiados por storyboard ^[7]. Ele suporta vídeo em 1080p, clipes de até 16 segundos e geração de áudio-vídeo com diálogo e efeitos sonoros sincronizados ^[1][2][4]. Pela Vidu Q3 Pro API, a saída em 720p custa US$ 0,12 por segundo na APIMart ^[2].

O Vidu Q3 Turbo pende mais para velocidade e menor custo, com troca de cena mais rápida ^[6][7]. Pela Vidu Q3 Turbo API, ele começa em US$ 0,032 por segundo em 540p e custa US$ 0,048 por segundo em 720p.

Vidu Q4 Preview: entrada de imagem e referências até 4K

O modelo mais novo, o Vidu Q4 Preview (viduq4-preview), trabalha apenas a partir de imagens: anima um único primeiro quadro ou monta um clipe com 1 a 15 imagens de referência e até três áudios MP3. Ele não faz texto-para-vídeo. Os clipes duram de 3 a 16 segundos, de 540p até 4K, e a Vidu Q4 API custa US$ 0,0912 por segundo em 720p para membros Gold da APIMart (em novembro de 2026). Se você precisa de texto-para-vídeo ou de transições de primeiro e último quadro, continue com o Q3 Pro ou o Q3 Turbo (documentação).

Como escolher entre MoE e série Q para o seu fluxo

Essa escolha se resume principalmente à complexidade do prompt, ao tempo de entrega e ao orçamento. Se o seu fluxo depende de seguimento estrito de instruções e lógica multi-cena, vá com o MoE. Se você precisa de saída refinada com sincronia áudio-visual, o Q3 Pro é o melhor encaixe. Como alternativa, o Kling V3 oferece outra opção de alta fidelidade para vídeo de IA cinematográfico. Se o seu objetivo principal é iteração rápida ou menor custo por clipe, o Q3 Turbo é a escolha prática.

A tabela abaixo mapeia cada modelo ao tipo de trabalho que ele lida melhor. Para quem compara opções de alto nível, o Veo 3.1 oferece texto-para-vídeo e imagem-para-vídeo cinematográficos até 4K.

A seguir, veja como selecionar um modelo, autenticar e enviar a requisição pela APIMart.

Como acessar o Vidu pela APIMart

Configuração de conta, autenticação e tratamento de chave de API

Depois de escolher um modelo, você pode enviar jobs pela APIMart com uma API key. Primeiro, crie uma conta na APIMart e gere sua chave na página de gerenciamento de API keys no dashboard ^[2][3].

Envie cada requisição com um token Bearer no cabeçalho Authorization:

Authorization: Bearer YOUR_API_KEY

Para armazenamento, mantenha as chaves em variáveis de ambiente ou em um gerenciador de segredos como o AWS Secrets Manager ou o GCP Secret Manager. Também ajuda usar chaves separadas para desenvolvimento, staging e produção. Se uma chave for exposta, rotacione-a imediatamente. Faça o mesmo em uma agenda fixa. E, ao registrar requisições, salve apenas o task_id - nunca o token em si ^[5].

Encontrando modelos Vidu, preços e esquema de entrada na APIMart

Uma vez logado, confira o catálogo antes de enviar qualquer coisa. É lá que você pode confirmar nomes de modelos, entradas suportadas e preços atuais. No catálogo da APIMart, os modelos Vidu estão listados em Geração de vídeo. Você também pode encontrar outros modelos de alto desempenho como o MiniMax-Hailuo-02 na mesma categoria. Use essa página para comparar esquema de entrada, resolução e custo por segundo entre MoE, Q3 Pro e Q3 Turbo ^[2][3].

Os principais campos a observar são:

• model
• prompt
• duration
• resolution
• aspect_ratio

Para jobs de texto-para-vídeo, use aspect_ratio. Para jobs baseados em imagem, o sistema usa a proporção da imagem de origem ^[2]. Os prompts de texto são limitados a 2.000 caracteres ^[2][3].

Endpoints, estrutura de requisição e tratamento de jobs assíncronos

Depois de escolher o modelo, envie a requisição de geração e acompanhe o job assíncrono com o task_id retornado. Envie uma requisição POST para https://api.apimart.ai/v1/videos/generations, depois faça polling do status do job com GET https://api.apimart.ai/v1/tasks/{task_id} ^[2][5].

Os jobs passam por estes estados:

• pending
• processing
• completed
• failed

A APIMart não envia webhooks para jobs do Vidu, então faça polling de GET /v1/tasks/{task_id} até o status ser completed ou failed. Assim que o job terminar, baixe o arquivo imediatamente; a URL do vídeo fica em data.result.videos[0].url[0]. A partir daí, você pode mapear os campos de requisição para um fluxo de texto-para-vídeo ou um fluxo baseado em referência.

Integração passo a passo para texto-para-vídeo e vídeo baseado em referência

Fluxo básico de texto-para-vídeo com seleção de modelo

Depois de escolher um modelo no catálogo, o fluxo de texto-para-vídeo é bem simples. Envie sua chave de API do lado do servidor no cabeçalho Authorization como Bearer {your_api_key}.

Aqui está um payload mínimo para um job de texto-para-vídeo com viduq3-pro:

{
  "model": "viduq3-pro",
  "prompt": "A red fox running through a snowy forest at dusk, cinematic slow motion",
  "duration": 8,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "audio": true
}

A resposta do envio retorna um task_id com o status submitted. Depois disso, faça polling de GET /v1/tasks/{task_id} com o task_id retornado; o job passa por pending e processing até chegar a completed ou failed ^[2]. Se quiser mudar para viduq3-turbo, você praticamente só muda o campo model.

O padrão assíncrono permanece o mesmo entre os modos. O que muda são os campos de entrada.

Adicionando entradas de imagem ou referência e controles avançados

Para imagem-para-vídeo, passe uma URL de imagem no array image_urls. Use 0 imagens para texto-para-vídeo, 1 para imagem-para-vídeo e 2 para o modo primeiro-último quadro ^[2]. Nos modos baseados em imagem, a proporção da saída vem da imagem de origem, então você pode omitir aspect_ratio ^[2]. Se você envia arquivos diretamente em vez de usar URLs, mantenha cada imagem em formato PNG, JPEG ou WebP, abaixo de 50 MB, e mantenha o corpo HTTP total abaixo de 20 MB ^[9][8].

Para geração baseada em referência na APIMart, use o mesmo endpoint POST /v1/videos/generations com model definido como viduq3 ou viduq3-mix, envie de 1 a 7 imagens de referência em image_urls e escreva um prompt obrigatório de até 5.000 caracteres (documentação). O array subjects e a sintaxe @subjectname existem apenas na plataforma própria da Vidu. Se você usa o modo primeiro-último quadro, mantenha ambas as imagens próximas em proporção, idealmente dentro de uma razão de 0,8 a 1,25, para reduzir falhas ^[8]. Quando rostos ou mãos estão envolvidos, mantenha os prompts de movimento sutis para reduzir artefatos de distorção ^[5].

A tabela abaixo mostra os principais parâmetros nos dois fluxos:

Defina um seed fixo durante os testes se quiser o mesmo resultado visual entre execuções ^[2][9].

Rastreando uso, custo e confiabilidade em produção

Uma vez que sua requisição esteja funcionando, o próximo trabalho é manter custo e confiabilidade sob controle em produção.

Registre o task_id e o timestamp de cada requisição. Isso lhe dá uma forma segura de depurar sem armazenar credenciais sensíveis ^[5]. Também ajuda rastrear o tempo de fila e o tempo de geração separadamente, para que você possa distinguir entre atraso de plataforma e latência de modelo.

Para estimativa de custo, o Vidu Q3 Pro em 720p custa cerca de $0.12 por segundo na APIMart, e o Q3 Turbo custa cerca de $0.048 por segundo ^[3][11]. Defina alertas automáticos em 50%, 80% e 100% do seu teto de orçamento mensal para que o gasto não fuja do controle ^[5].

As tentativas também importam. Em erros 5xx, use backoff exponencial: tente novamente em 2 segundos, depois 5 segundos, depois 15 segundos antes de mostrar um erro ao usuário ^[5]. Falhas de curta duração ainda acontecem, então as tentativas devem fazer parte de qualquer build de produção.

Checklist de seleção de modelo e principais conclusões

Checklist de caso de uso para devs, criadores e equipes de produto

Escolha com base em três coisas: complexidade do prompt, velocidade e qualidade de saída. A tabela abaixo transforma a comparação de modelos em uma escolha prática de entrega.

Depois de escolher uma linha, mantenha o mesmo esquema de requisição da seção de integração. Em palavras simples: comece as ideias no Q3 Turbo, depois leve a renderização final em 1080p para o Q3 Pro. É um fluxo simples e ajuda você a se mover rápido sem gastar mais do que precisa.

Para clipes onde a fidelidade de movimento importa mais, mire em 5 a 10 segundos em vez de esticar até o máximo de 16 segundos. Clipes mais curtos costumam dar movimento mais apertado e menos dor de cabeça.

Pontos-chave para lembrar antes de entregar

O MoE é a escolha para lógica complexa multi-cena. O Q3 Pro lhe dá saída cinematográfica de alta fidelidade em 1080p ^[3]. O Q3 Turbo é a opção de menor custo a US$ 0,048/seg em 720p ^[3].

Na APIMart, alternar entre esses modelos é apenas uma única mudança do parâmetro model. Todo o resto da requisição permanece igual ^[3]. Isso significa que você pode testar um modelo, trocar para outro e manter seu trabalho de integração estável.

Use o mesmo fluxo assíncrono sempre:

• Envie a requisição
• Capture o task_id
• Faça polling de GET /v1/tasks/{task_id} até o status ser completed

Além disso, baixe os vídeos gerados logo após estarem prontos. A APIMart guarda os resultados por 72 horas ^[3][11].

Perguntas frequentes

Com qual modelo Vidu devo começar?

Comece com o modelo que se encaixa nas suas necessidades de velocidade, áudio e controle visual.

• viduq3-pro: melhor para sincronia áudio-visual e segmentação de planos
• viduq3-turbo: geração mais rápida que a versão pro
• viduq3 ou viduq3-mix: referência-para-vídeo com 1 a 7 imagens; viduq4-preview para entrada de imagem ou referências até 4K

Como rastreio um job de vídeo após enviá-lo?

Na APIMart, uma tarefa do Vidu é acompanhada por polling.

Guarde o task_id da resposta do envio e chame GET /v1/tasks/{task_id} em intervalos regulares. A APIMart não envia webhooks para jobs do Vidu, então não há callback_url para configurar.

Quando o status mudar para completed, a resposta trará a URL do vídeo em data.result.videos[0].url[0]. Se mudar para failed, confira a mensagem de erro antes de tentar de novo.

Que entradas e limites devo conhecer antes de integrar?

Antes de integrar a API Vidu, garanta que suas entradas fiquem dentro destes limites:

• Imagens: apenas PNG, JPEG, JPG ou WebP; cada arquivo deve ter menos de 50 MB e pelo menos 128×128 pixels
• Corpo HTTP total da requisição: máximo de 20 MB
• Prompts de texto: até 2.000 caracteres no Q3 Pro e no Q3 Turbo, e até 5.000 caracteres no Q3 e no Q3 Mix

Os limites de duração dependem do modelo que você usa. O Q3 Pro, o Q3 Turbo e o Q3 Mix suportam 1 a 16 segundos, enquanto o Q3 e o Q4 Preview suportam 3 a 16 segundos.

Além disso, mantenha suas chaves de API seguras. Não as exponha em código do lado do cliente. Envie as requisições por um intermediário do lado do servidor.