Ir para o conteúdo

Veo3.1 Reference to Video

Integrar

ID do modelo veo3.1/reference-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/veo3.1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

Esta solicitação: $ 3,20 3.200 créditos de API Executar nesta página

Obter chave de API
Google Referência para vídeo Áudio nativoSaída em 4KEntradas de referênciaaté 4k

Vídeo do Veo 3.1 que mantém um assunto consistente usando várias imagens de referência, com áudio opcional

Google · 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 / 20000

Descrição textual do vídeo desejado para geração.

•obrigatório image_urls
Solte um arquivo ou

URLs de imagens de referência usadas para manter consistente a aparência do sujeito.

aspect_ratio padrão 16:9

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

resolution padrão 720p

Resolução usada para o vídeo de saída.

padrão 8s

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

Avançado safety_tolerance · auto_fix
safety_tolerance padrão 4

Defina a tolerância da moderação de conteúdo entre o nível menos restritivo, 6, e o nível mais rigoroso, 1, que bloqueia a maior parte do conteúdo.

POST /run/veo3.1/reference-to-video?wait=20 cotação → $ 3,20
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/veo3.1/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",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/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 Veo3.1 Reference to Video

Gera um vídeo a partir de um `prompt` e de uma lista de imagens de referência em `image_urls`, mantendo a aparência do assunto consistente. A proporção é 16:9 ou 9:16, e a resolução é 720p, 1080p ou 4k. A duração padrão é 8s, e a geração de áudio vem ativada 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
≤ 20.000 caracteres
Descrição textual do vídeo desejado para geração.
aspect_ratioopcional
Tipoenum
Padrão16:9
16:99:16
Proporção da imagem do vídeo de saída.
durationopcional
Tipostring
Padrão8s
Duração do vídeo de saída.
resolutionopcional
Tipoenum
Padrão720p
720p1080p4k
Resolução usada para o vídeo de saída.
generate_audioopcional
Tipoboolean
Padrãotrue
Controla se o vídeo inclui áudio gerado.
auto_fixopcional
Tipoboolean
Padrãofalse
Reescrita automática de prompts para tentar resolver falhas nas verificações de política de conteúdo ou em outras validações.
safety_toleranceopcional
Tipoenum
Padrão4
123456
Defina a tolerância da moderação de conteúdo entre o nível menos restritivo, 6, e o nível mais rigoroso, 1, que bloqueia a maior parte do conteúdo.
image_urlsobrigatório images
Tipourl[] · image
URLs de imagens de referência usadas para manter consistente a aparência do sujeito.
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": "veo3.1/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": 3200,
    "usd": "3.20",
    "charged": 3200,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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
    }
  },
  "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://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/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.

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/veo3.1/reference-to-video.md. Todos os modelos e guias: https://doitong.com/developers/llms.txt