API 550W para Remoção de Legendas e Marca de Água

O que a API para programadores 550W realmente suporta

A API para programadores 550W permite que um backend submeta tarefas de remoção de legendas ou texto de vídeo e tarefas de remoção de marca de água de imagem sem enviar os utilizadores através de um editor manual. Foi concebida para plataformas de criadores, pipelines de localização, bibliotecas de media 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ídeo, submeta filmagens em MP4 ou MOV através de /open/uploadVideo ou forneça um videoUrl público para /open/submitTask. O pedido inclui dimensões do vídeo, duração e o retângulo a reparar. As tarefas de vídeo são executadas de forma assíncrona e podem ser verificadas através de /open/taskDetail ou /open/taskList.

Remoção de marca de água de imagem

Para imagens, /open/removeImageWatermark aceita ficheiros JPG, PNG, BMP, WebP, AVIF, TIFF ou SVG até 50 MB. Pode aguardar um resultado ou devolver uma tarefa de processamento para consulta posterior. A API para programadores Eraser não expõe a transferência de marca de água de links de vídeo, pelo que 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 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 HTTPS publicamente acessível.

Autenticar e transferir

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

Os vídeos transferidos suportam MP4 e MOV, um tamanho máximo de ficheiro de 1 GB, duração até 600 segundos e processamento até 1080p dentro das regras de dimensão documentadas. Valide o formato, duração, dimensões, profundidade de bits e estado HDR antes de submeter para que suportes não suportados nunca entrem 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 paisagens que mudam lentamente são geralmente mais fáceis do que mãos, cabelo, roupas com padrões, reflexos ou movimento rápido da câmara. Crie uma fila de revisão para casos limite e compare toda a linha temporal, não apenas uma miniatura.

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 bem-sucedidas incluem code e message; as respostas de tarefa expõem adicionalmente status e, quando completas, resultUrl. As tarefas falhadas podem incluir failCode, failReason e refundStatus. Repita falhas temporárias de transporte ou internas com backoff exponencial, mas não repita cegamente parâmetros inválidos, suportes não suportados, contas suspensas ou erros de crédito insuficiente.

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.