Introdução
Apague uma região fixa ao longo de todo o vídeo usando uma máscara de imagem branca sobre fundo preto. Uma instrução opcional descreve a remoção local; a mesma máscara se aplica ao clipe inteiro.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O vídeo completo a processar, com duração de 1 a 600 segundos. A região selecionada é processada durante o clipe inteiro. pelo menos 1 caracteres |
mask_url | Sim | Uma imagem PNG estática alinhada ao quadro do vídeo. Pinte a área a remover de branco e a área restante de preto. pelo menos 1 caracteres |
prompt | Não | Orientação opcional para a remoção local. Ela não seleciona um intervalo de tempo nem ativa o rastreamento. |
Preços
$0.024 / segundo
Cobrança pelo clipe de entrada inteiro, com arredondamento para cima em segundos inteiros e mínimo cobrado de 3 segundos. Este endpoint aceita clipes de 1 a 600 segundos; o tamanho da máscara não reduz a duração.
Casos de uso
Vídeo → Edição de vídeo → Vídeo
Edição de vídeo
Vídeo
Tarefa assíncrona
Guia de prompt e dicas práticas
Introdução
O Video Eraser remove o conteúdo dentro de uma máscara de imagem estática ao longo de um clipe de vídeo inteiro. Envie video_url e mask_url, com um prompt curto opcional descrevendo a remoção. Ele é adequado para uma faixa fixa de legendas ou outro elemento indesejado que permaneça na mesma região da tela. O fundo resultante é um preenchimento inferido, não a recuperação de pixels originais ocultos.
Principais recursos e destaques
Uma região fixa para o clipe inteiro
A máscara é uma imagem estática: o branco marca a área a apagar, e o preto marca a área a preservar. A mesma região da tela se aplica ao vídeo inteiro enviado. Não há campo de tempo inicial, campo de tempo final nem controle de rastreamento de objetos em movimento. Uma legenda que se mova para fora da região branca não será coberta por essa máscara. O conteúdo que atravessar a região selecionada também poderá ser alterado pelo preenchimento.
Uma descrição opcional junto à máscara
Uma breve descrição pode esclarecer o que deve ser removido e o que há ao redor. A máscara continua sendo obrigatória neste endpoint para que a região fique explícita. O processamento é cobrado pelo clipe de entrada completo, com arredondamento para cima em segundos inteiros e duração mínima cobrada de 3 segundos. São aceitos clipes de origem de 1 a 600 segundos. Uma máscara menor não reduz a duração de vídeo cobrada.
Casos de uso
Remover uma faixa fixa de legendas
Para legendas já gravadas na imagem do seu próprio material, marque a faixa de legendas e inspecione cada trecho em que o texto aparece. Um fundo estático é um bom ponto de partida para verificar o resultado. Se as legendas ainda forem camadas de texto editáveis no projeto, remova essas camadas diretamente antes de optar pela reconstrução de pixels.
Limpar uma sobreposição imóvel
Use uma máscara bem ajustada para uma sobreposição indesejada no canto do material que você está editando. Verifique os quadros em que uma pessoa ou um produto passa por trás da área selecionada, ou em que um movimento de câmera altera o conteúdo atrás dela. Nesses momentos, o preenchimento precisa inferir conteúdo variável e pode revelar cintilação ou bordas distorcidas que não são evidentes em um único quadro de prévia.
Guia de prompts e dicas práticas
Crie uma máscara sem ambiguidades
Prepare uma máscara PNG alinhada ao quadro de origem: branco dentro da região a remover e preto fora dela. Verifique o posicionamento no primeiro quadro, no quadro do meio e no último antes de enviar. Evite regiões brancas maiores que o necessário, especialmente quando se sobrepõem a um rosto ou a um detalhe importante do produto. A máscara é estática e afeta o clipe inteiro; ela não consegue acompanhar legendas em movimento nem limitar a edição a um intervalo de tempo selecionado.
Descreva a edição local e compare o resultado
Uma instrução opcional como “Remova a faixa fixa de legendas e preencha com o fundo ao redor” descreve a alteração desejada sem inventar uma nova cena. Compare a saída com o original na velocidade normal de reprodução e quadro a quadro nos trechos com movimentos difíceis. Verifique as áreas sem máscara, a duração do clipe, a taxa de quadros e o som, além da região apagada. A preservação do áudio original e a preservação exata dos pixels fora da máscara não foram verificadas, então guarde o arquivo de origem.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.