API 550W Video Eraser para legendas e marcas de água em vídeos e imagens

O que a API para programadores 550W realmente suporta

A API para programadores da 550W permite ao servidor enviar tarefas autorizadas para tratar legendas/texto ou uma marca de água visível dentro de um retângulo selecionado, bem como marcas de água em imagens. O acesso à API não concede direitos sobre o material de origem e os resultados têm de ser revistos.

Tratamento de legendas e marcas de água em vídeo

Para vídeo, carregue um ficheiro MP4 ou MOV através de /open/uploadVideo ou forneça uma videoUrl pública a /open/submitTask. Indique as dimensões, a duração e o retângulo a tratar. A tarefa é assíncrona; consulte o estado em /open/taskDetail ou /open/taskList.

Remoção de marca de água de imagem

Para imagens, /open/removeImageWatermark aceita JPG, PNG, BMP, WebP, AVIF, TIFF e SVG até 50 MB. A chamada pode devolver o resultado ou uma tarefa para consulta posterior. A API não descarrega vídeos com marcas de água a partir de ligações; não anuncie essa possibilidade.

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

Um fluxo de pedido pronto para produção

Cada pedido é autenticado com userNo e apiKey. Mantenha ambos os valores no seu servidor: colocar uma chave API no código do navegador ou do cliente móvel torna-a recuperável por utilizadores e extensões. Um vídeo pode ser transferido primeiro ou fornecido como um URL HTTP(S) publicamente acessível.

Autenticar e transferir

Envie width, height, duration e x1, y1, x2, y2 para /open/submitTask. Standard (mode=normal, predefinido) 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 apenas se for necessário retirar o áudio antes do processamento.

Submeter uma tarefa idempotente

Envie um Idempotency-Key de no máximo 128 caracteres para criação segura em caso de repetição. Se uma ligação cair após a submissão, repita com a mesma chave em vez de criar uma segunda tarefa faturável. Armazene o taskId retornado junto com o seu próprio ID de ativo.

Receber e verificar o resultado

Para entrega assíncrona, forneça um callbackUrl HTTP(S) público. O webhook é acionado quando a tarefa atinge um estado final. O seu manipulador deve confirmar rapidamente, verificar a tarefa novamente através de /open/taskDetail e tratar entregas repetidas do webhook como normais. O polling permanece útil como caminho de recuperação quando uma chamada de retorno é atrasada.

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

Limites de entrada e controlos de qualidade

As regras de entrada da API podem diferir das do editor no navegador. Consulte 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 do movimento junto ao texto. Um céu ou uma parede uniforme costuma ser mais simples do que mãos, cabelo, roupa com padrões ou reflexos. Reveja todo o vídeo, sobretudo quando o fundo muda.

Rever filmagens difíceis

As tarefas de imagem suportam formatos web e de design comuns e custam um número fixo de créditos por tarefa bem-sucedida de acordo com a página atual da API. Preserve o ficheiro de origem e guarde o resultado como um derivativo; a remoção de marca de água não cria permissão de direitos de autor 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.

Faturação, falhas e política de repetição

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

Estimar o custo antes da submissão

As respostas incluem code e message. Uma tarefa pode ainda devolver status, resultUrl e, se falhar, failCode, failReason e refundStatus. Repita erros temporários com intervalos crescentes; corrija primeiro parâmetros inválidos, ficheiros incompatíveis ou créditos insuficientes.

Tratar campos de falha estáveis

Registe a latência de submissão, latência de conclusão, taxa de falha, taxa de rejeição de revisão e custo por ativo aprovado. Estas métricas revelam se a automação está a melhorar o fluxo de trabalho em vez de apenas mover trabalho manual a jusante.

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

Lançar a integração em quatro passos

Primeiro, gere uma chave API a partir da página localizada do programador 550W e submeta um vídeo representativo. Segundo, implemente a consulta de tarefa e apresente os estados de espera, processamento, sucesso e falha no seu próprio produto. Terceiro, adicione idempotência e um webhook com recuperação por polling. Finalmente, execute um lote controlado e reverta cada saída antes de aumentar a concorrência.

Pilotar antes de escalar

Use controlos separados de desenvolvimento e produção, rode credenciais expostas, restrinja o acesso ao suporte de origem e mantenha uma política de eliminação para resultados. Equipas com critérios de aceitação claros podem então ligar a API a um DAM, CMS, fila de localização ou fluxo de trabalho de upload de criadores sem sacrificar a revisão editorial.