API do Video Eraser para Remoção de Legendas e Marca d'água

O que a API para desenvolvedores 550W realmente suporta

A API para desenvolvedores 550W permite que um backend envie jobs de remoção de legendas ou texto de vídeo e jobs de remoção de marca d'água de imagem sem enviar os usuários por um editor manual. Foi projetada para plataformas de criadores, pipelines de localização, bibliotecas de mídia e ferramentas internas que processam repetidamente conteúdo que a organização possui ou tem licença para editar.

Remoção de legendas e texto de vídeo

Para vídeos, envie footage MP4 ou MOV através de /open/uploadVideo ou forneça uma videoUrl pública para /open/submitTask. A requisição inclui dimensões do vídeo, duração e o retângulo a reparar. Os jobs de vídeo são executados de forma assíncrona e podem ser verificados através de /open/taskDetail ou /open/taskList.

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

Para imagens, /open/removeImageWatermark aceita arquivos JPG, PNG, BMP, WebP, AVIF, TIFF ou SVG de até 50 MB. Pode aguardar um resultado ou retornar uma task para consulta posterior. A API para desenvolvedores do Eraser não expõe download de marca d'água de link de vídeo, portanto, as integrações não devem prometer essa funcionalidade.

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 HTTPS publicamente acessível.

Autenticar e enviar

Envie /open/submitTask com width, height, duration e x1, y1, x2, y2. Um retângulo bem ajustado geralmente preserva mais detalhes do que um reparo em tela cheia. Use mode=protect quando o fluxo de trabalho suportado exigir reconstrução conservadora, e removeAudio apenas quando o áudio deve ser removido 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 HTTPS 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

Vídeos enviados suportam MP4 e MOV, tamanho máximo de arquivo de 1 GB, duração de até 600 segundos e processamento de até 1080p dentro das regras de dimensão documentadas. Valide formato, duração, dimensões, profundidade de bits e status HDR antes de enviar para que mídia não suportada nunca entre na fila paga.

Validar antes de gastar créditos

A qualidade depende do que se move atrás da legenda ou texto. Paredes planas, céu e cenários que mudam lentamente geralmente são mais fáceis do que mãos, cabelo, roupas com padrões, reflexos ou movimento rápido da câmera. Crie uma fila de revisão para casos extremos e compare toda a linha do tempo, não apenas uma miniatura.

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

Respostas bem-sucedidas incluem code e message; respostas de task adicionalmente expõem status e, quando completo, resultUrl. Tasks com falha podem incluir failCode, failReason e refundStatus. Repita falhas de transporte internas ou temporárias com backoff exponencial, mas não repita cegamente parâmetros inválidos, mídia não suportada, contas suspensas ou erros de créditos insuficientes.

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.