Ir 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"

Arquivos como o exemplo: $ 0,10 100 créditos de API seus arquivos 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 junto com seus efeitos na cena, usando um vídeo de máscara ou um prompt de máscara textual

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

Descrição que especifica a aparência desejada do fundo depois que o objeto for removido.

•obrigatório video_url
Solte um arquivo ou

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

padrão
Solte um arquivo ou

URL do vídeo da máscara de remoção; se ausente, o aplicativo cria uma máscara de vídeo temporária pelo endpoint de vídeo SAM-3 usando `mask_prompt` e a converte automaticamente em uma quadmask. Para obter melhores resultados, forneça uma quadmask no estilo VOID usando 4 valores em tons de cinza: 255 para o fundo mantido, 127 para a região afetada, 63 para a sobreposição e 0 para o objeto removido. Máscaras binárias também são aceitas, usando 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 do alvo da máscara para que o SAM-3 crie um vídeo de máscara temporário quando nenhum `quad_mask_video_url` for fornecido. Identifique o que deve ser mascarado, por exemplo, um objeto ou pessoa a ser removido do vídeo de origem.

padrão The video is not of a...

Prompt negativo que descreve resultados indesejados para afastar a geração deles.

padrão 30

Quantidade de etapas de remoção de ruído. Aumentá-la melhora a qualidade, mas adiciona latência.

padrão 1

Intensidade da orientação sem classificador.

padrão 1

Intensidade da remoção de ruído, com 1.0 indicando remoção completa de ruído.

padrão 85

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

Seed que controla a aleatoriedade para 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 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 Void Video Inpainting

Recebe `video_url` e um `prompt` que descreve o fundo desejado. Forneça um `quad_mask_video_url` ou informe `mask_prompt` para gerar uma máscara. Os controles 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 PadrãoPermitido Descrição
video_urlobrigatório video
Tipourl · video
URL do vídeo de origem que contém o objeto a ser removido.
quad_mask_video_urlopcional
Tipourl · video
Padrão
URL do vídeo da máscara de remoção; se ausente, o aplicativo cria uma máscara de vídeo temporária pelo endpoint de vídeo SAM-3 usando `mask_prompt` e a converte automaticamente em uma quadmask. Para obter melhores resultados, forneça uma quadmask no estilo VOID usando 4 valores em tons de cinza: 255 para o fundo mantido, 127 para a região afetada, 63 para a sobreposição e 0 para o objeto removido. Máscaras binárias também são aceitas, usando 255 para manter e 0 para remover.
mask_promptopcional
Tipostring | null
Instruções do alvo da máscara para que o SAM-3 crie um vídeo de máscara temporário quando nenhum `quad_mask_video_url` for fornecido. Identifique o que deve ser mascarado, por exemplo, um objeto ou pessoa a ser removido do vídeo de origem.
promptobrigatório
Tipostring
Descrição que especifica a aparência desejada do fundo depois que o objeto for removido.
enable_pass2_refinementopcional
Tipoboolean
Padrãofalse
Refinamento VOID opcional que troca um processamento mais lento por uma consistência temporal potencialmente melhor em clipes mais longos. Aplica refinamento de ruído deformado como Pass 2, após Pass 1.
negative_promptopcional
Tipostring
Padrã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 para afastar a geração deles.
num_inference_stepsopcional
Tipointeger
Padrão30
1 – 50
Quantidade de etapas de remoção de ruído. Aumentá-la melhora a qualidade, mas adiciona latência.
guidance_scaleopcional
Tiponumber
Padrão1
0 – 20
Intensidade da orientação sem classificador.
strengthopcional
Tiponumber
Padrão1
0 – 1
Intensidade da remoção de ruído, com 1.0 indicando remoção completa de ruído.
seedopcional
Tipointeger | null
Seed que controla a aleatoriedade para resultados reproduzíveis.
num_framesopcional
Tipointeger
Padrão85
1 – 197
Janela de inferência temporal solicitada, ajustada pelo backend para um dos tamanhos seguros do CogVideoX: 69, 77, 85, ..., 197. O tamanho mais próximo é selecionado para acomodar a compressão temporal e o processamento em blocos.
enable_safety_checkeropcional
Tipoboolean
Padrãotrue
Habilita verificações de segurança para o conteúdo gerado.
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": "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"
  }
}
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 resultante após a remoção do objeto.
seed
integerValor de seed aplicado durante a geração.
timings
objectDetalhes de tempo por etapa do pipeline.

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