Introdução
Isole o primeiro plano de um clipe existente e escolha transparência ou um fundo de cor sólida. A solicitação padrão pede WebM VP9 transparente com o áudio original.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | Clipe de origem de 1 a 60 segundos. A saída isola o primeiro plano detectado; não há controle de recorte. pelo menos 1 caracteres |
background | Não | Escolha transparência ou uma das dez cores sólidas. A saída transparente requer um formato compatível com alfa. |
output_format | Não | Predefinição de contêiner e codec. WebM VP9 é o padrão. |
keep_original_audio | Não | Solicita o áudio original na saída; ativado por padrão. Desative para obter um clipe sem som. Valor padrão: |
Preços
$0.06 / segundo
A cobrança é por segundo do vídeo de entrada, com arredondamento para cima até o segundo inteiro. Este endpoint aceita clipes de 1 a 60 segundos. As opções de fundo, formato e áudio não alteram essa regra baseada na duração.
Casos de uso
Vídeo → Edição de vídeo → Vídeo
Edição de vídeo
Vídeo
Tarefa assíncrona
Guia de prompt e dicas práticas
Introdução
A ferramenta de remoção de fundo de vídeo isola o primeiro plano de um vídeo existente para composição ou para colocá-lo sobre um fundo de cor sólida. Envie video_url e escolha o fundo e o formato de exportação. A solicitação padrão pede WebM VP9 transparente e mantém o áudio original. Este endpoint aceita clipes de origem de 1 a 60 segundos; ele não gera uma nova cena a partir de um prompt.
Principais recursos e destaques
A transparência depende da escolha de fundo e formato
Defina background como transparent e use um formato com suporte a alfa. WebM VP9, MOV ProRes 4444, MKV VP9 e GIF são opções documentadas com alfa. As predefinições MP4 e as predefinições MKV H.264 ou H.265 não incluem alfa aqui; solicitações incompatíveis de transparência podem ser rejeitadas. MOV H.265 tem apenas suporte parcial documentado, então use WebM VP9 no fluxo de trabalho transparente padrão e confira a saída real antes da composição.
Cores sólidas e som original
Você também pode escolher preto, branco, cinza, vermelho, verde, azul, amarelo, ciano, magenta ou laranja. keep_original_audio controla se o áudio de origem é solicitado no resultado. GIF não pode conter uma faixa de áudio; desative a preservação de áudio ao escolhê-lo. As opções de contêiner, codec e fundo não alteram a regra de cobrança baseada na duração. A cobrança usa os segundos de entrada arredondados para cima, e este endpoint não oferece controle de recorte nem de resolução de saída.
Casos de uso
Colocar um apresentador sobre uma apresentação
Comece com um clipe curto em que o apresentador esteja claramente separado do fundo. Solicite WebM VP9 transparente e depois coloque o resultado sobre o slide ou a cena em um editor compatível com esse formato. Inspecione os cabelos e as bordas com desfoque de movimento sobre fundos escuros e claros antes de publicar a composição.
Preparar um clipe de produto para um novo layout
Separe um produto do cenário original para reutilizar a filmagem em um layout de catálogo ou em uma edição para redes sociais. A exportação com cor sólida pode ser útil quando a transparência não é necessária. Superfícies reflexivas e bordas finas exigem uma análise cuidadosa: o resultado é uma máscara processada e deve ser avaliado sobre o fundo pretendido, e não apenas em uma prévia quadriculada.
Guia de prompts e dicas práticas
Escolher o formato de entrega com cuidado
Mantenha background=transparent, output_format=webm_vp9 e keep_original_audio=true no fluxo de trabalho de vídeo padrão. Escolha outra predefinição somente após verificar se o editor consegue importá-la. O suporte à reprodução na web varia conforme o navegador e o codec; um download bem-sucedido não prova que uma prévia incorporada ou uma edição posterior funcionará. Preserve o arquivo mestre transparente ao criar uma prévia separada, achatada sobre um fundo, para compartilhar.
Verificar a transparência e o clipe completo
Inspecione o canal alfa real e componha o resultado sobre preto, branco e uma cor saturada. Um arquivo que mostra um padrão quadriculado ou um retângulo preto não comprova que a transparência funciona. Revise todo o movimento para identificar mudanças nas bordas e compare a duração, as dimensões dos quadros e a sincronização do áudio com o original. Não deduza a presença de alfa pelo nome do arquivo ou pelas opções selecionadas. Esta integração ainda não tem um teste concluído de qualidade de mídia ou de compatibilidade com navegadores; valide o resultado no fluxo de trabalho pretendido.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/background-remover-video-v1/video-edit",
"input": {
"background": "transparent",
"output_format": "webm_vp9",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
