Ir 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Arquivos como o exemplo: $ 0,333 333 créditos de API · ≈ ₽ 35,49 seus arquivos 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

Referência para vídeo Q4 usando até 12 imagens e 3 clipes de voz, 3-16 segundos, até 4K

Vidu · Vídeo

Seu primeiro resultado aparecerá aqui

Monte uma requisição abaixo e execute-a com sua chave de API. As saídas são copiadas para nosso armazenamento, mantidas para sempre ou por 7 dias gratuitamente.

Criar uma solicitação

Os controles são gerados a partir do esquema do modelo. O código e o preço são atualizados conforme você os altera.

•obrigatório 88 / 5000

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

aspect_ratio padrão 16:9

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

resolution padrão 720p

Resolução do vídeo resultante.

padrão 5

Duração do vídeo em segundos, variando de 3 a 16.

Avançado images · reference_audio_urls · seed · audio · enable_safety_checker
reference_image_urls
Solte um arquivo ou

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

Solte um arquivo ou

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

Seed que torna a geração reproduzível. Defini-lo 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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar esta solicitação

Sua chave permanece neste navegador: ela é enviada somente à Doitong API e salva (localStorage) apenas se você marcar Lembrar. Obter uma chave de API

Sobre Vidu Q4 Reference to Video

Mantém personagens, objetos e vozes consistentes usando até 12 `reference_image_urls` e até 3 clipes mp3 em `reference_audio_urls` (3-12 segundos cada). O prompt, de até 5000 caracteres, faz referência às referências por posição. `duration` é de 3-16 segundos, `resolution` de até 4K, e `audio` vem desativado por padrão.

Parâmetros

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

NomeTipo PadrãoPermitido Descrição
promptobrigatório
Tipostring
≤ 5.000 caracteres
Prompt de geração de vídeo com limite de 5000 caracteres. Referencie imagens usando as posições da lista, como [@reference_image_1] e [@reference_image_2]; para clipes de áudio, use [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 assunto, 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 clipes mp3, cada um com duração de 3–12 segundos e tamanho máximo de 50 MB.
durationopcional
Tipointeger
Padrão5
3 – 16
Duração do vídeo em segundos, variando de 3 a 16.
seedopcional
Tipointeger | null
Seed que torna a geração reproduzível. Defini-lo como None seleciona uma seed aleatoriamente.
aspect_ratioopcional
Tipoenum
Padrão16:9
16:99:164:33:41:1
Proporção do vídeo de saída.
resolutionopcional
Tipoenum
Padrão720p
540p720p1080p2K4K
Resolução do vídeo resultante.
audioopcional
Tipoboolean
Padrãofalse
Ativação da trilha sonora do vídeo: false mantém o resultado sem som; ativá-la gera diálogo e efeitos sonoros junto com o vídeo.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
A filtragem pode ser relaxada definindo false, desde que o chamador esteja autorizado.
obrigatório Nome canônico, também aceito

Os parâmetros de arquivo aceitam uma URL https:// pública, um URI data: de até 10 MB ou o file_url de um upload. Arquivos

Saída

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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Seus arquivos, sua escolhaCada outputs[].url é uma cópia em nosso armazenamento: mantida para sempre (cobrada por GB-mês) ou por 7 dias gratuitamente, conforme a configuração da sua conta ou ?storage=.
Mesmo formato em todos os modelostype, url, content_type, width, height e duration, para imagens, vídeos e áudios. output é o próprio objeto de resultado do modelo.
Campos da saída
video
object {url, content_type, file_name, file_size}Vídeo produzido pelo modelo Q4 Preview usando referências.
cover_image
object {url, content_type, file_name, file_size, width, height} | nullImagem de capa do vídeo resultante.
seed
integerSemente aleatória aplicada durante a geração.

Mais modelos: Referência para vídeo

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