API do Video Eraser para legendas e marcas d’água em vídeos e imagens

O que a API para desenvolvedores 550W realmente suporta

A API para desenvolvedores da 550W permite que o servidor envie tarefas autorizadas para processar legendas/textos ou uma marca d’água visível dentro de um retângulo selecionado, além de marcas d’água em imagens. O acesso à API não concede direitos sobre o material original, e os resultados precisam ser revisados.

Processamento de legendas e marcas d’água em vídeo

Para vídeos, envie um arquivo MP4 ou MOV por /open/uploadVideo ou informe uma videoUrl pública em /open/submitTask. Inclua dimensões, duração e o retângulo a processar. A tarefa é assíncrona; acompanhe o estado por /open/taskDetail ou /open/taskList.

Remoção de marca d'água de imagem

Para imagens, /open/removeImageWatermark aceita JPG, PNG, BMP, WebP, AVIF, TIFF e SVG de até 50 MB. A chamada pode devolver um resultado ou uma tarefa para consulta posterior. A API não oferece download de vídeo com marca d’água a partir de links; não anuncie esse recurso.

Use a API para limpeza autorizada de legendas/texto de vídeo e remoção de marca d'água de imagem; mantenha fluxos de trabalho de marca d'água de link de vídeo não suportados fora da promessa do seu produto.

Um fluxo de requisição pronto para produção

Toda requisição é autenticada com userNo e apiKey. Mantenha ambos os valores no seu servidor: colocar uma chave de API em código de navegador ou cliente móvel a torna recuperável por usuários e extensões. Um vídeo pode ser enviado primeiro ou fornecido como uma URL HTTP(S) publicamente acessível.

Autenticar e enviar

Envie width, height, duration e x1, y1, x2, y2 para /open/submitTask. Standard (mode=normal, padrão) processa a área dentro do retângulo. Protect (mode=protect) preserva o interior e processa o exterior; não é um modo de qualidade superior. Use removeAudio somente se for necessário remover o áudio antes do processamento.

Enviar um job idempotente

Envie um Idempotency-Key de no máximo 128 caracteres para criação segura contra repetições. Se uma conexão cair após o envio, tente novamente com a mesma chave em vez de criar um segundo job faturável. Armazene o taskId retornado junto com o ID do seu asset.

Receber e verificar o resultado

Para entrega assíncrona, forneça uma callbackUrl HTTP(S) pública. O webhook é disparado quando a task atinge um estado final. Seu manipulador deve confirmar rapidamente, verificar a task novamente através de /open/taskDetail e tratar a entrega repetida do webhook como normal. O polling permanece útil como caminho de recuperação quando uma callback é atrasada.

Credenciais no lado do servidor, idempotência, IDs de task duráveis e verificação de webhook tornam as repetições seguras e observáveis.

Limites de entrada e controles de qualidade

As regras de entrada da API podem diferir das do editor no navegador. Confira a documentação atual e valide formato, duração, dimensões, profundidade de bits e HDR antes de consumir créditos.

Validar antes de gastar créditos

O resultado depende dos detalhes e movimentos ao redor do texto. Céu e paredes uniformes costumam ser mais simples do que mãos, cabelos, tecidos estampados ou reflexos. Analise o vídeo inteiro, especialmente os trechos em que o fundo muda.

Revisar filmagens difíceis

Jobs de imagem suportam formatos comuns da web e de design e custam um número fixo de créditos por task bem-sucedida de acordo com a página atual da API. Preserve o arquivo de origem e salve o resultado como um derivativo; a remoção de marca d'água não cria permissão de direitos autorais ou uso comercial.

Rejeite entradas não suportadas cedo e exija revisão humana sempre que a área de reparo cruze detalhes importantes em movimento.

Cobrança, falhas e política de repetição

A remoção de legenda de vídeo é cobrada por duração e resolução. O cronograma atual é de 1,3 créditos por segundo em 720p ou abaixo e 1,6 créditos por segundo acima de 720p até 1080p. Um vídeo de 30 segundos em 1280×720 é, portanto, cerca de 39 créditos, enquanto um vídeo de 30 segundos em 1920×1080 é cerca de 48 créditos. Consulte /open/queryCredits antes de aceitar um lote grande.

Estimar custo antes do envio

As respostas trazem code e message. Uma tarefa também pode incluir status, resultUrl e, em caso de falha, failCode, failReason e refundStatus. Repita erros temporários com intervalos progressivos; antes de tentar novamente, corrija parâmetros inválidos, mídia incompatível ou falta de créditos.

Tratar campos de falha estáveis

Registre latência de envio, latência de conclusão, taxa de falha, taxa de rejeição de revisão e custo por ativo aprovado. Essas métricas revelam se a automação está melhorando o fluxo de trabalho em vez de apenas mover trabalho manual para as etapas seguintes.

Uma integração útil mede saída aprovada e custo efetivo, não apenas respostas HTTP bem-sucedidas.

Lance a integração em quatro passos

Primeiro, gere uma chave de API na página do desenvolvedor 550W localizada e envie um vídeo representativo. Segundo, implemente consulta de task e exiba estados de esperando, processando, sucesso e falha no seu próprio produto. Terceiro, adicione idempotência e um webhook com recuperação por polling. Por último, execute um lote controlado e revise toda a saída antes de aumentar a concorrência.

Pilote antes de escalar

Use controles separados de desenvolvimento e produção,.rotatecredenciais expostas, restrinja o acesso à mídia de origem e mantenha uma política de exclusão para resultados. Equipes com critérios de aceitação claros podem então conectar a API a um DAM, CMS, fila de localização ou fluxo de trabalho de envio de criadores sem sacrificar a revisão editorial.