Avançar para o conteúdo

Void Video Inpainting

Integrar

ID do modelo void-video-inpainting
# 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/void-video-inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "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,10 $ 100 créditos da API os seus ficheiros são medidos antes da execução Executar nesta página

Obter chave de API
Open model Vídeo para vídeo #utility#editing

Remove um objeto de um vídeo, juntamente com os seus efeitos na cena, usando um vídeo de máscara ou um prompt de máscara textual

Open model · 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

Descrição que especifica o aspeto que o fundo deve ter depois de o objeto ser removido.

•obrigatório video_url
Largue um ficheiro ou

URL do vídeo de origem que contém o objeto a remover.

predefinição
Largue um ficheiro ou

URL do vídeo da máscara de remoção; se estiver ausente, a aplicação cria uma máscara de vídeo temporária através do endpoint de vídeo SAM-3 utilizando `mask_prompt` e converte-a automaticamente numa quadmask. Para obter melhores resultados, forneça uma quadmask ao estilo VOID com 4 valores de escala de cinzentos: 255 para o fundo mantido, 127 para a região afetada, 63 para a sobreposição e 0 para o objeto removido. Também são aceites máscaras binárias, utilizando 255 para manter e 0 para remover.

Avançado mask_prompt · negative_prompt · num_inference_steps · guidance_scale · strength · num_frames · seed · enable_safety_checker

Instruções para o alvo da máscara, utilizadas pelo SAM-3 para criar um vídeo de máscara temporário quando não é fornecido `quad_mask_video_url`. Identifique o que deve ser mascarado, por exemplo um objeto ou pessoa a remover do vídeo de origem.

predefinição The video is not of a...

Prompt negativo que descreve resultados indesejados, orientando a geração para os evitar.

predefinição 30

Contagem de passos de redução de ruído. Aumentá-la melhora a qualidade, mas acrescenta latência.

predefinição 1

Intensidade da orientação sem classificador.

predefinição 1

Intensidade da redução de ruído, em que 1.0 indica uma redução de ruído completa.

predefinição 85

Janela de inferência temporal solicitada, ajustada pelo backend para um dos tamanhos seguros do CogVideoX 69, 77, 85, ..., 197. É selecionado o tamanho mais próximo para acomodar a compressão temporal e o particionamento.

Seed que controla a aleatoriedade para obter resultados reproduzíveis.

POST /run/void-video-inpainting?wait=20 cotação → 0,10 $
# 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/void-video-inpainting?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "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 Void Video Inpainting

Aceita `video_url` e um `prompt` que descreve o fundo pretendido. Forneça um `quad_mask_video_url` ou indique `mask_prompt` para gerar uma máscara. Os controlos incluem `num_frames` (1-197), `num_inference_steps` (1-50), `guidance_scale`, `strength` e um `enable_pass2_refinement` opcional e mais lento para consistência temporal.

Parâmetros

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

NomeTipo PredefiniçãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
URL do vídeo de origem que contém o objeto a remover.
quad_mask_video_urlopcional
Tipourl · video
Predefinição
URL do vídeo da máscara de remoção; se estiver ausente, a aplicação cria uma máscara de vídeo temporária através do endpoint de vídeo SAM-3 utilizando `mask_prompt` e converte-a automaticamente numa quadmask. Para obter melhores resultados, forneça uma quadmask ao estilo VOID com 4 valores de escala de cinzentos: 255 para o fundo mantido, 127 para a região afetada, 63 para a sobreposição e 0 para o objeto removido. Também são aceites máscaras binárias, utilizando 255 para manter e 0 para remover.
mask_promptopcional
Tipostring | null
Instruções para o alvo da máscara, utilizadas pelo SAM-3 para criar um vídeo de máscara temporário quando não é fornecido `quad_mask_video_url`. Identifique o que deve ser mascarado, por exemplo um objeto ou pessoa a remover do vídeo de origem.
promptobrigatório
Tipostring
Descrição que especifica o aspeto que o fundo deve ter depois de o objeto ser removido.
enable_pass2_refinementopcional
Tipoboolean
Predefiniçãofalse
Refinamento VOID opcional que troca um processamento mais lento por uma consistência temporal potencialmente melhor em clips mais longos. Aplica refinamento de ruído deformado como Pass 2, depois de Pass 1.
negative_promptopcional
Tipostring
PredefiniçãoThe video is not of a high quality, it has a low resolution. Watermark present in each frame. The background is solid. Strange body and strange trajectory. Distortion.
Prompt negativo que descreve resultados indesejados, orientando a geração para os evitar.
num_inference_stepsopcional
Tipointeger
Predefinição30
1 – 50
Contagem de passos de redução de ruído. Aumentá-la melhora a qualidade, mas acrescenta latência.
guidance_scaleopcional
Tiponumber
Predefinição1
0 – 20
Intensidade da orientação sem classificador.
strengthopcional
Tiponumber
Predefinição1
0 – 1
Intensidade da redução de ruído, em que 1.0 indica uma redução de ruído completa.
seedopcional
Tipointeger | null
Seed que controla a aleatoriedade para obter resultados reproduzíveis.
num_framesopcional
Tipointeger
Predefinição85
1 – 197
Janela de inferência temporal solicitada, ajustada pelo backend para um dos tamanhos seguros do CogVideoX 69, 77, 85, ..., 197. É selecionado o tamanho mais próximo para acomodar a compressão temporal e o particionamento.
enable_safety_checkeropcional
Tipoboolean
Predefiniçãotrue
Ativa as verificações de segurança do conteúdo gerado.
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": "void-video-inpainting",
  "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": 100,
    "usd": "0.10",
    "charged": 100,
    "refunded": 0
  },
  "input": {
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4",
    "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
    },
    "seed": 42,
    "timings": {}
  },
  "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 resultante após a remoção do objeto.
seed
integerValor da seed aplicado durante a geração.
timings
objectDetalhes dos tempos de cada etapa do pipeline.

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