Avançar para o conteúdo

Vidu Q4 Reference to Video

Integrar

ID do modelo vidu/q4/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Ficheiros como o exemplo: 0,333 $ 333 créditos da API os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Vidu Referência para vídeo Saída em 4KEntradas de referência3–16 saté 4K #reference-to-video#multi-shot

Reference-to-video Q4 com até 12 imagens e 3 clipes de voz, 3-16 segundos, até 4K

Vidu · Vídeo

O seu primeiro resultado aparece aqui

Crie um pedido abaixo e execute-o com a sua chave de API. As saídas são copiadas para o nosso armazenamento, guardadas para sempre ou durante 7 dias gratuitamente.

Criar um pedido

Os controlos são gerados a partir do esquema do modelo. O código e o preço são atualizados à medida que os altera.

•obrigatório 88 / 5000

Prompt de geração de vídeo com um limite de 5000 caracteres. Referencie imagens utilizando as posições da respetiva lista, como [@reference_image_1] e [@reference_image_2]; para clips de áudio, utilize [reference_audio_1] e [reference_audio_2], continuando a numeração para as entradas seguintes.

aspect_ratio predefinição 16:9

Proporção do vídeo de saída.

resolution predefinição 720p

Resolução do vídeo resultante.

predefinição 5

Duração do vídeo em segundos, entre 3 e 16.

Avançado images · reference_audio_urls · seed · audio · enable_safety_checker
reference_image_urls
Largue um ficheiro ou

Imagens de referência para manter a consistência do sujeito, fornecidas como URLs ou URIs de dados base64. Aceita até 12 imagens nos formatos png, jpeg, jpg ou webp.

Largue um ficheiro ou

Áudio de referência para manter a consistência da voz, fornecido como URLs ou URIs de dados base64. Aceita até 3 clips mp3, cada um com 3–12 segundos e tamanho máximo de 50 MB.

Seed que torna a geração reproduzível. Defini-la como None seleciona uma seed aleatoriamente.

POST /run/vidu/q4/reference-to-video?wait=20 cotação → 0,333 $
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/vidu/q4/reference-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar este pedido

A sua chave permanece neste navegador: é enviada apenas para a Doitong API e guardada em localStorage apenas se selecionar Lembrar. Obter uma chave de API

Sobre Vidu Q4 Reference to Video

Mantém a consistência de personagens, objetos e vozes usando até 12 `reference_image_urls` e até 3 clipes mp3 em `reference_audio_urls` (3-12 segundos cada). O prompt, com até 5000 caracteres, referencia as referências pela posição. `duration` é de 3-16 segundos, `resolution` até 4K e `audio` está desativado por predefinição.

Parâmetros

Envie o nome canónico ou o nome nativo, não ambos. Nomes canónicos

NomeTipo PredefiniçãoPermitido Descrição
promptobrigatório
Tipostring
≤ 5000 caracteres
Prompt de geração de vídeo com um limite de 5000 caracteres. Referencie imagens utilizando as posições da respetiva lista, como [@reference_image_1] e [@reference_image_2]; para clips de áudio, utilize [reference_audio_1] e [reference_audio_2], continuando a numeração para as entradas seguintes.
reference_image_urlsopcional images
Tipourl[] · image
Imagens de referência para manter a consistência do sujeito, fornecidas como URLs ou URIs de dados base64. Aceita até 12 imagens nos formatos png, jpeg, jpg ou webp.
reference_audio_urlsopcional
Tipourl[] · audio
Áudio de referência para manter a consistência da voz, fornecido como URLs ou URIs de dados base64. Aceita até 3 clips mp3, cada um com 3–12 segundos e tamanho máximo de 50 MB.
durationopcional
Tipointeger
Predefinição5
3 – 16
Duração do vídeo em segundos, entre 3 e 16.
seedopcional
Tipointeger | null
Seed que torna a geração reproduzível. Defini-la como None seleciona uma seed aleatoriamente.
aspect_ratioopcional
Tipoenum
Predefinição16:9
16:99:164:33:41:1
Proporção do vídeo de saída.
resolutionopcional
Tipoenum
Predefinição720p
540p720p1080p2K4K
Resolução do vídeo resultante.
audioopcional
Tipoboolean
Predefiniçãofalse
Ativação da banda sonora do vídeo: false mantém o resultado sem som; ao ativá-la, são gerados diálogo e efeitos sonoros juntamente com o vídeo.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
A filtragem pode ser flexibilizada definindo false, desde que o autor do pedido esteja autorizado.
obrigatório Nome canónico, também aceite

Os parâmetros de ficheiro aceitam um URL https:// público, um URI data: até 10 MB ou o file_url de um carregamento. Ficheiros

Resultado

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "vidu/q4/reference-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 333,
    "usd": "0.333",
    "charged": 333,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "cover_image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Os seus ficheiros, a sua escolhaCada outputs[].url é uma cópia no nosso armazenamento: guardada para sempre (paga por GB-mês) ou durante 7 dias gratuitamente, conforme a definição da sua conta ou ?storage=.
A mesma estrutura em todos os modelostype, url, content_type, width, height e duration, tanto para imagens como para vídeo e áudio. output é o próprio objeto de resultado do modelo.
Campos do resultado
video
object {url, content_type, file_name, file_size}Vídeo produzido pelo modelo Q4 Preview utilizando referências.
cover_image
object {url, content_type, file_name, file_size, width, height} | nullImagem de capa do vídeo resultante.
seed
integerSeed aleatória aplicada durante a geração.

Mais modelos: Referência para vídeo

Para agentes de IA: esta página em Markdown está disponível em https://doitong.com/pt-PT/developers/models/vidu/q4/reference-to-video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt