Vídeo

Vidu Q4 Preview API

Vidu Q4 API na APIMart (model ID viduq4-preview, muitas vezes escrito viduq4): o Vidu Q4 Preview da ShengShu transforma um primeiro quadro, ou 1–15 imagens de referência com até 3 clipes de áudio de referência, em vídeos de 3–16 segundos até 4K com áudio nativo. É o modelo mais recente da família Vidu API na APIMart.

Imagem para vídeoReferências para vídeo3–16 segundosAté 4K

Obter Chave de API Documentação da API

Destaques do Serviço

Descontos Oficiais
Pagamento conforme uso
Rápido e baixa latência

Input

Modelo

Modo de geração

Primeiro Frame

Prompt

Resolução

Duração5s

Áudio

Seed

Output

Video link valid for 72 hours

Detalhes de Preços

Preços transparentes sem taxas ocultas. Pague apenas pelo que usar.

Variante	Nível	Preço OuroPreço atual	Preço Platina	Preço Diamante	Preço oficial	Sua economia
`viduq4-preview`	540p	0.448Credits(~$0.0448)/seg	0.4256Credits(~$0.0426)/seg	0.4032Credits(~$0.0403)/seg	0.56Credits(~$0.056)/seg	20%
	720p	0.912Credits(~$0.0912)/seg	0.8664Credits(~$0.0866)/seg	0.8208Credits(~$0.0821)/seg	1.14Credits(~$0.114)/seg	20%
	1080p	1.024Credits(~$0.1024)/seg	0.9728Credits(~$0.0973)/seg	0.9216Credits(~$0.0922)/seg	1.28Credits(~$0.128)/seg	20%
	2K	1.624Credits(~$0.1624)/seg	1.5428Credits(~$0.1543)/seg	1.4616Credits(~$0.1462)/seg	2.03Credits(~$0.203)/seg	20%
	4K	3.328Credits(~$0.3328)/seg	3.1616Credits(~$0.3162)/seg	2.9952Credits(~$0.2995)/seg	4.16Credits(~$0.416)/seg	20%

* Os custos reais dependem da saída final.

Vidu Q4 API: anime imagens e referências em até 4K

Gere vídeos com o Vidu Q4 online no gerador acima ou chame a Vidu Q4 API pelo seu app. Comece com um primeiro quadro e um prompt opcional, ou combine 1–15 imagens de referência, um prompt e até 3 MP3. Escolha 3–16 segundos e de 540p a 4K; o áudio vem ativado por padrão, pelo mesmo preço.

Recursos da API Vidu Q4 Preview

Entradas compatíveis, controles de saída e processamento assíncrono

Imagem inicial ou referências

I2V usa uma imagem inicial; R2V usa de 1 a 15 imagens de referência. Aceita PNG, JPEG e WEBP, até 50 MB cada. Não aceita entrada só de texto nem quadros finais.

Prompts conforme o modo

Descreva ação, câmera ou cena com até 20.000 caracteres. O prompt é opcional na geração com imagem inicial e obrigatório na geração por referências.

Cinco resoluções de saída

Escolha 540p, 720p, 1080p, 2K ou 4K. O padrão é 720p. Ajuste a resolução ao canal de publicação, às necessidades visuais e ao orçamento.

Clipes de 3 a 16 segundos

Defina uma duração inteira entre 3 e 16 segundos, com padrão de 5. Avalie o movimento em um clipe curto antes de planejar uma cena mais longa.

Áudio gerado e de referência

O áudio gerado vem ativado; desativá-lo não altera o preço. R2V também aceita até 3 MP3, cada um com 3–12 segundos e até 50 MB, sem acréscimo por materiais.

Controle de semente

Use uma semente inteira para explorar resultados relacionados. Omita o valor ou use 0 para uma semente aleatória. Revise o movimento antes de publicar.

Fluxo unificado de tarefas

Envie POST /v1/videos/generations e guarde o task_id. Consulte GET /v1/tasks/{task_id} até a conclusão ou falha, sem criar novamente a tarefa.

Cobrança por resolução

Os dois modos cobram duração multiplicada pela tarifa atual por segundo da resolução escolhida. Imagens e áudio de referência, assim como áudio gerado, não acrescentam custo. Consulte o preço da conta; tarefas com falha têm reembolso integral.

Usos de vídeos de imagens e referências

Fluxos criativos a partir de uma imagem inicial aprovada ou de referências

Clipes de produtos e marcas

Anime uma foto de produto em uma apresentação breve. Sugira o movimento e revise os detalhes do produto e a adequação à marca no resultado.

Conteúdo para redes sociais

Transforme uma imagem escolhida em uma abertura de 3 a 16 segundos. Selecione a resolução conforme o canal e escolha entre áudio ou saída silenciosa.

Storyboards e propostas

Anime um quadro de storyboard ou combine referências e prompt para explorar a cena e a direção de câmera. Revise cada clipe antes de usá-lo na edição final.

Estudos de movimento de personagens

Explore movimentos de retratos e ilustrações ou guie uma cena com referências de personagem e áudio opcional. Revise identidade, movimento e adequação antes de usar.

Educação e explicações

Anime uma cena ou ilustração preparada para uma lição curta. Verifique a precisão visual e acrescente narração ou legendas conferidas durante a edição.

Conceitos de jogos e ambientes

Dê movimento a um conceito de ambiente ou cena de jogo. Use os clipes para explorar a atmosfera e realizar revisões criativas internas.

Como obter uma API key do Vidu Q4 e começar

Três passos para seu primeiro vídeo com Vidu Q4 na APIMart.

Cadastre-se e adicione saldo

Crie uma conta na APIMart e adicione saldo. Ele vale para todos os modelos da plataforma, incluindo a Vidu API.

→

Crie sua API key

Gere uma API key no painel. A mesma key chama o Vidu Q4 e todos os outros modelos da APIMart.

→

Envie a primeira requisição

POST /v1/videos/generations com model viduq4-preview e consulte GET /v1/tasks/{task_id} até o vídeo ficar pronto.

Comece a Criar

Exemplo da Vidu Q4 API: imagem para vídeo e referências para vídeo

Chame o Vidu Q4 Preview na APIMart com uma única requisição POST. A geração é assíncrona: envie uma tarefa e consulte o endpoint de tarefas para obter a URL do vídeo.

1
Autentique as requisições da Vidu Q4 API
Salve sua key da APIMart na variável de ambiente APIMART_API_KEY e envie-a como Authorization: Bearer <key> em cada requisição.
2
Envie uma tarefa do Vidu Q4
POST /v1/videos/generations com model viduq4-preview e os arquivos do exemplo. O ID da tarefa está em data[0].task_id.
3
Obtenha o vídeo do Vidu Q4
Consulte GET /v1/tasks/{task_id} até status ser completed e leia a URL do vídeo em data.result.videos[0].url[0]. Os resultados ficam guardados por 72 horas, então baixe-os a tempo.
Veja a referência da Vidu Q4 Preview API para cada parâmetro, regra de arquivos e campo de resposta.

POST /v1/videos/generations

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "A câmera se aproxima devagar enquanto a pessoa se vira e sorri",
    "image_urls": [
      "https://example.com/first-frame.png"
    ],
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }'

import os
import time
import requests

API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}

# 1. Submit the generation task
payload = {
  "model": "viduq4-preview",
  "prompt": "A câmera se aproxima devagar enquanto a pessoa se vira e sorri",
  "image_urls": [
    "https://example.com/first-frame.png"
  ],
  "duration": 5,
  "resolution": "720p",
  "audio": True
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]

# 2. Poll the task until it finishes
for _ in range(200):
    task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
    task_resp.raise_for_status()
    task = task_resp.json()["data"]
    if task["status"] == "completed":
        print(task["result"]["videos"][0]["url"][0])
        break
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
    time.sleep(10)
else:
    raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "O personagem da imagem 1 caminha pela rua da imagem 2 ao pôr do sol, diálogo natural e sons da cidade",
    "image_urls": [
      "https://example.com/character.png",
      "https://example.com/scene.png"
    ],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

TASK_ID="task_xxx"  # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIMART_API_KEY"

Parâmetros da Vidu Q4 API

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
`model`	string	Sim	Padrão: —	Use viduq4-preview.
`prompt`	string	Opcional	Padrão: —	Até 20.000 caracteres. Opcional em imagem para vídeo, obrigatório em referências para vídeo.
`image_urls`	string[]	Opcional	Padrão: —	URLs públicas ou data URLs em Base64. 1 imagem para imagem para vídeo, 1–15 para referências para vídeo.
`image_with_roles`	object[]	Opcional	Padrão: —	Imagens com função: first_frame, ou reference_image para referências para vídeo.
`first_frame_image`	string	Opcional	Padrão: —	Primeiro quadro só para imagem para vídeo. Não combine com outras imagens nem com áudio.
`audio_urls`	string[]	Opcional	Padrão: —	Até 3 clipes MP3 de referência, de 3–12 segundos cada, só para referências para vídeo.
`duration`	integer	Opcional	Padrão: 5	Duração em segundos: 3–16. Padrão 5.
`resolution`	string	Opcional	Padrão: 720p	Resolução de saída: 540p, 720p, 1080p, 2K ou 4K. Padrão 720p.
`aspect_ratio`	string	Opcional	Padrão: 16:9	1:1, 9:16, 16:9, 3:4 ou 4:3 em referências para vídeo. Padrão 16:9; ignorado em imagem para vídeo.
`audio`	boolean	Opcional	Padrão: true	Gera diálogos e efeitos sonoros. Padrão true; false retorna um vídeo sem som.
`seed`	integer	Opcional	Padrão: —	Seed inteira que controla a aleatoriedade. Omita para uma seed aleatória.

Família de modelos Vidu API

Compare todos os modelos de vídeo Vidu na APIMart. Uma única API key chama todos eles, com cobrança por segundo de vídeo.

Modelo	Ideal para	Resolução	Duração
Vidu Q4 Preview APIEsta página	Geração mais recente: anime um primeiro quadro ou combine de 1 a 15 imagens de referência com até 3 clipes de áudio	540p – 4K	3–16s
Vidu Q3 Pro API	Texto para vídeo, imagem para vídeo e primeiro-último quadro, com áudio por padrão	540p / 720p / 1080p	1–16s
Vidu Q3 Turbo API	Os mesmos modos do Vidu Q3 Pro com o menor preço por segundo da série Vidu	540p / 720p / 1080p	1–16s
Vidu Q3 API	Referência para vídeo do dia a dia com 1 a 7 imagens e troca inteligente de ângulo de câmera	540p / 720p / 1080p	3–16s
Vidu Q3 Mix API	Referência para vídeo premium com 1 a 7 imagens, transições inteligentes mais fortes e efeitos curtos de movimento	720p / 1080p	1–16s

Perguntas sobre a API Vidu Q4 Preview

Entradas, parâmetros, cobrança e resultados

O que é o Vidu Q4 Preview?

O Vidu Q4 Preview é o modelo de vídeo Vidu mais recente da ShengShu na APIMart, também buscado como Vidu Q4, viduq4 ou Vidu AI Q4. O ID da API é viduq4-preview. Ele anima um primeiro quadro ou segue 1–15 imagens de referência, com áudio de referência opcional, e gera clipes de 3–16 segundos até 4K.

Quando o Vidu Q4 foi lançado?

A ShengShu lançou o Vidu Q4 Preview em 7 de outubro de 2026, e ainda não há data anunciada para a versão final do Vidu Q4. Na APIMart, a Vidu Q4 API chama o Vidu Q4 Preview com o model ID viduq4-preview.

O Vidu Q4 Preview e a Vidu Q4 API são a mesma coisa?

Sim. O Vidu Q4 Preview é a versão do Vidu Q4 disponível hoje, e a Vidu Q4 API da APIMart o chama com o model ID viduq4-preview. Escreva o model ID exatamente assim, em minúsculas.

Vidu Q4 Preview aceita texto para vídeo?

Não. viduq4-preview exige imagens: uma imagem inicial em I2V ou de 1 a 15 referências em R2V. R2V também aceita até 3 clipes de áudio de referência. Geração somente por texto e controle combinado de quadros inicial e final não são suportados.

Como escolher imagem inicial ou referências?

first_frame_image ou o papel first_frame seleciona I2V, assim como uma imagem sem papel e sem áudio de referência. O papel reference_image (alias reference), várias imagens ou imagens sem papel com áudio de referência selecionam R2V. Não misture um quadro inicial explícito com referências ou áudio de referência. image_urls e image_with_roles compartilham o limite de 15 referências. PNG, JPEG/JPG e WEBP: até 50 MB cada; requisições Base64 devem ficar abaixo de 20 MB.

As instruções são obrigatórias?

O prompt é opcional em I2V e obrigatório em R2V, com até 20.000 caracteres nos dois modos. Descreva a ação, a cena e como as referências devem orientar o vídeo.

Qual é a duração máxima de um vídeo do Vidu Q4 e quais resoluções ele suporta?

Os vídeos do Vidu Q4 Preview têm no máximo 16 segundos. Duração inteira de 3–16 segundos, padrão 5. Resoluções: 540p, 720p, 1080p, 2K e 4K, padrão 720p. R2V aceita 1:1, 9:16, 16:9, 3:4 e 4:3, com padrão 16:9. aspect_ratio tem prioridade sobre o alias size. I2V ignora ambos os campos e segue a imagem inicial.

Como funcionam áudio e semente?

O áudio gerado é true por padrão; false produz vídeo silencioso ao mesmo preço. R2V aceita 0–3 MP3 de referência, com 3–12 segundos e até 50 MB cada. Formato e duração são verificados pelo provedor; um clipe inválido pode gerar falha com reembolso. Seed aceita um inteiro; omitir ou usar 0 solicita um valor aleatório.

Quanto custa a Vidu Q4 API?

O Vidu Q4 é cobrado por segundo de saída conforme a resolução escolhida. Em 4 de novembro de 2026, os preços Gold são 540p $0,0448, 720p $0,0912, 1080p $0,1024, 2K $0,1624 e 4K $0,3328 por segundo, então um clipe de 5 segundos em 720p custa cerca de $0,46. Com ou sem áudio o preço é o mesmo, e imagens ou áudios de referência não têm custo extra. A tabela de preços mostra os valores atuais.

Sou cobrado se uma tarefa do Vidu Q4 falhar?

Não. Erros de parâmetro, como misturar um primeiro quadro com imagens de referência ou exceder o limite de imagens ou áudios, retornam HTTP 400 no envio, sem criar a tarefa nem cobrar. Se uma tarefa falhar durante a geração, por exemplo por um áudio de referência inválido, ela é reembolsada integralmente de forma automática.

Como obtenho uma API key do Vidu Q4?

Cadastre-se na APIMart, adicione saldo e crie uma key na página API Keys. A mesma key chama o Vidu Q4, os modelos Vidu Q3 e todos os outros modelos da APIMart, com pagamento por uso e sem assinatura.

Como obtenho o vídeo gerado?

POST /v1/videos/generations retorna um task_id. Consulte GET /v1/tasks/{task_id} a cada 5–10 segundos até completed ou failed. Os links de vídeo ficam em data.result.videos[0].url[0].

Por quanto tempo os vídeos do Vidu Q4 ficam guardados?

Os resultados ficam guardados por 72 horas, então baixe-os a tempo. Se uma consulta de status expirar, a tarefa não falhou necessariamente; continue consultando o task ID original em vez de enviar outra.

Posso testar o Vidu Q4 online?

Sim. Entre na APIMart, crie uma API key e adicione saldo; depois use o gerador no topo desta página para criar vídeos com o Vidu Q4 no navegador. O playground chama a mesma API e é cobrado por segundo com os mesmos preços, e os vídeos prontos aparecem nas suas gerações recentes.

Vidu Q4 vs Vidu Q3: qual usar?

Use o Vidu Q4 para saída até 4K, 1–15 imagens de referência ou áudio de referência. O Vidu Q4 exige uma imagem, então para texto para vídeo ou primeiro e último quadro use o Vidu Q3 Pro ou Q3 Turbo. Para vídeo por referências com 1–7 imagens, o Vidu Q3 custa menos por segundo que o Vidu Q4, e o Vidu Q3 Mix aceita clipes a partir de 1 segundo.

Vidu Q4 vs Seedance 2.5 vs Kling 4.0: qual usar?

Use o Vidu Q4 para saída de até 4K a partir de um primeiro quadro ou de até 15 imagens de referência; em 5 de novembro de 2026, custa $0,0912 por segundo em 720p para membros Gold, mas não faz texto para vídeo e os clipes vão até 16 segundos. Use o Seedance 2.5 para até 30 segundos em até 1080p com texto para vídeo, edição e extensão de vídeo, e até 50 referências. Use o Kling 4.0 para clipes de 3–30 segundos em 720p ou 1080p com áudio estéreo sempre ativo, além de edição e extensão. Os preços do Seedance 2.5 e do Kling 4.0 estão nas páginas de cada modelo.

Modelos Relacionados

Explore mais modelos da mesma categoria.

Ver Todos os Modelos →