Sobre o Video Background Remover
Um vídeo master transparente para sua próxima composição.
Chame com o nome de modelo popnow/background-remover-video-v1/video-edit em POST /jobs/createTask, a partir de US$ 0,06.
Por enquanto este guia está só em inglês. →
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
background | Não | Manter, remover ou trocar o fundo. transparent · black · white · gray · red · green · blue · yellow · cyan · magenta · orange · Padrão: transparent |
keep_original_audio | Não | Keep the source audio in an output format that supports audio. GIF does not carry sound. Padrão: true |
output_format | Não | Tipo de arquivo do resultado. webm_vp9 · mp4_h264 · mp4_h265 · mov_h265 · mov_proresks · mkv_h264 · mkv_h265 · mkv_vp9 · gif · Padrão: webm_vp9 |
video_url | Sim | O clipe a ser trabalhado. |
Preços
Os preços são em USD. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
| Opção | USD por segundo de entrada |
|---|---|
| Padrão | US$ 0,06 |
A duração da entrada é arredondada para cima ao segundo inteiro, com mínimo de 1 segundos.
Antes de executar, envie o mesmo corpo de requisição para POST /jobs/quote para ver o custo estimado e o máximo em USD. O orçamento não executa tarefas nem debita seu saldo.
Início rápido da API
Chame a API do Video Background Remover em três passos
- Crie uma chave de API. Entre na PopNow e crie uma chave no console da API. As chaves começam com sk-popnow-. As chamadas usam seu saldo separado em dólares americanos.
- Envie a requisição. Faça POST /jobs/createTask com model popnow/background-remover-video-v1/video-edit e um objeto input conforme a tabela de parâmetros. A resposta traz um ID de tarefa na hora.
- Pegue o resultado. Consulte GET /jobs/recordInfo com o ID da tarefa, ou passe uma callBackUrl e enviamos o resultado para ela. Baixe os links de saída quando a tarefa der certo.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/background-remover-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Troque o prompt e os links pelos seus. A aba API traz a referência da resposta, do polling e do callback.
Perguntas sobre a API do Video Background Remover
Quanto custa a API do Video Background Remover?
O Video Background Remover custa US$ 0,06 por segundo. A API usa um saldo separado em dólares americanos. Os créditos do site não podem ser usados na API nem convertidos em saldo de API, e o saldo de API não pode ser convertido em créditos do site. Ao aceitar uma tarefa, reservamos o valor máximo do orçamento no seu saldo de API. Ao concluir, cobramos o uso real sem ultrapassar a reserva e liberamos o restante. Se a tarefa falhar, o valor reservado é liberado.
Qual é o nome de modelo do Video Background Remover na API?
Coloque popnow/background-remover-video-v1/video-edit para Remover fundo do vídeo no campo model de POST /jobs/createTask.
Quais configurações solicitam uma saída transparente?
Use background=transparent com output_format=webm_vp9. Guarde o arquivo mestre com alfa resultante para composição e verifique o canal real antes de usar.
A preservação de áudio se aplica a GIF?
Não. GIF não tem faixa de áudio. Desative keep_original_audio ao solicitar GIF.
Posso presumir que o resultado funciona em todos os navegadores?
Não. O suporte a contêineres e codecs varia. Verifique a reprodução e a edição no navegador ou aplicativo em que o resultado será usado.
Quais são os limites da API do Video Background Remover?
Clipe de entrada mais longo: 60 s. Requisições fora desses limites são rejeitadas antes de qualquer cobrança.
Dá para testar o Video Background Remover sem escrever código?
Execute Video Background Remover no Playground com seu saldo de API em USD, sem chave de API. Cada execução aparece no histórico de desenvolvedor com o código correspondente.