Introdução
O que este endpoint faz
Ele recebe um vídeo e devolve uma cópia em que até três rostos por quadro, começando pelo maior, são restaurados e deixados mais nítidos. O resultado fica estável de quadro para quadro. Movimento, enquadramento, duração e a faixa de áudio original são mantidos, e a resolução não muda. Não há prompt.
Entradas que importam
video_url é o clipe: um upload em MP4 ou uma URL pública, de 3 segundos a 5 minutos de duração. Escolha para o Video Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração facial quadro a quadro com Video Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto. Escolha para o Video Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração facial quadro a quadro com Video Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto.
O que você recebe
Um vídeo por requisição, na resolução, taxa de quadros e duração que você enviou, com o seu áudio, servido pelo armazenamento da plataforma quando a tarefa termina. Para mais pixels, use /models/video-upscaler-v1.
| Campo | Valor |
|---|---|
| Entrada | Vídeo |
| Saída | Vídeo |
| Endpoint | Edição de vídeo |
| Rostos | Até três por quadro, começando pelo maior |
| Controles | Sem prompt — o clipe é a requisição inteira |
| Cobrança | Por segundo do clipe de entrada, mínimo de 3 segundos |
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
video_url | Sim | O clipe a restaurar: um upload em MP4 ou um link público, de 3 segundos a 5 minutos. Clipes fora dessa faixa são recusados antes de qualquer cobrança. pelo menos 1 caracteres |
Preços
$0.012 / segundo de saída
Cobrado por segundo do clipe de entrada, arredondado para cima até o próximo segundo inteiro, com mínimo de 3 segundos. Um upload fica reservado pela sua própria duração e uma URL pelo máximo de 5 minutos até a entrega; a diferença é liberada, e requisições com falha não são cobradas.
Casos de uso
Clipes de podcast e entrevista
Filmagens de pessoa falando, comprimidas com força para upload, perdem detalhe no rosto primeiro. Passe por aqui uma vez para trazer de volta olhos, dentes e linha do cabelo, enquanto o ambiente, o enquadramento e o som continuam iguais.
Filmagens antigas ou muito comprimidas
Clipes que foram salvos, compartilhados e recodificados várias vezes ficam moles e com blocos ao redor do rosto. Até três rostos por quadro são restaurados, então um clipe com um ou dois falantes bem visíveis é o caso ideal.
Filmagens que você vai ampliar depois
Deixe os rostos limpos primeiro e depois use o Video Upscaler em /models/video-upscaler-v1 se o clipe também precisar de mais pixels para uma tela maior.
Guia de prompt e dicas práticas
Confira o clipe
Um MP4 entre 3 segundos e 5 minutos, com rostos humanos reais relativamente grandes e bem visíveis. Corte antes na parte que você precisa.
Envie
video_urlvideo_urlé um upload em MP4 ou um link público. É o único campo: não há prompt e não há nada para ajustar.Consulte e compare
A chamada é assíncrona: crie a tarefa, consulte até terminar e baixe o vídeo do armazenamento da plataforma. Compare com a origem em velocidade normal e em um quadro pausado, e confira se o áudio está intacto.
Introdução
Video Face Enhancer restaura e deixa mais nítidos os rostos em cada quadro de um clipe. Você envia video_url; a ferramenta encontra até três rostos por quadro, começando pelo maior, e reconstrói o detalhe que a compressão forte ou o desfoque levaram embora, mantendo o resultado estável de um quadro para o seguinte. Movimento, enquadramento, duração e a faixa de áudio original permanecem como estavam, e o clipe volta na resolução que você enviou. Aceitamos arquivos MP4 de 3 segundos a 5 minutos, e não há prompt.
Principais recursos e destaques
Rostos limpos em cada quadro
A restauração roda sobre o clipe inteiro, não sobre uma imagem parada. Em nosso teste pegamos um clipe de 5 segundos em 640×360 de uma apresentadora de podcast e o degradamos com compressão H.264 forte. Ele voltou em 640×360 e 24 fps, ainda com 5,0 segundos, após cerca de 21 segundos de processamento. Olhos, dentes e a linha do cabelo ficaram mais nítidos em cada quadro e não piscaram, e a apresentadora continuava reconhecível como a mesma pessoa.
O resto continua como estava
Áudio, movimento, enquadramento e duração são mantidos, e a área ao redor dos rostos fica intacta: o ambiente atrás da apresentadora não mudou. A ferramenta não amplia o vídeo. Se você também precisar de mais pixels, use o Video Upscaler (/models/video-upscaler-v1).
A cobrança acompanha a duração do clipe
A cobrança é por segundo do clipe de entrada, arredondado para cima até o próximo segundo inteiro, com mínimo de 3 segundos. Clipes com menos de 3 segundos ou com mais de 5 minutos são recusados antes de qualquer cobrança. Quando o clipe é um upload cuja duração pode ser lida, a reserva é essa duração; para uma URL, a cotação mantém o máximo de 5 minutos até a entrega, e a diferença é liberada. Requisições com falha não são cobradas.
Casos de uso
Clipes de podcast e entrevista
Filmagens de pessoa falando, comprimidas com força para upload, perdem detalhe no rosto primeiro. Passe o clipe uma vez para trazer de volta olhos, dentes e linha do cabelo, enquanto o ambiente, o enquadramento da câmera e o som continuam iguais.
Filmagens antigas ou muito comprimidas
Clipes que foram salvos, compartilhados e recodificados várias vezes ficam moles e com blocos ao redor do rosto. Até três rostos por quadro são restaurados, começando pelo maior, então um clipe com um ou dois falantes bem visíveis é o caso ideal.
Filmagens que você pretende ampliar depois
Limpe os rostos primeiro e depois use o Video Upscaler (/models/video-upscaler-v1) se o clipe também precisar de mais pixels para uma tela maior.
Guia de prompts e dicas práticas
Não há prompt: escolha o clipe
A única entrada é video_url, um upload em MP4 ou um link público, de 3 segundos a 5 minutos. Corte o clipe na parte que você precisa antes de enviar, porque a cobrança acompanha a duração do que você envia.
Escolha rostos que podem ser recuperados
Escolha para o Video Face Enhancer um rosto real, visível e grande o bastante na imagem; a restauração facial quadro a quadro com Video Face Enhancer aproveita melhor esses detalhes do que um rosto distante ou oculto. O Video Face Enhancer tem menos informação facial se a origem é desenho ou anime, ou o rosto é pequeno, coberto ou muito borrado; isso limita a restauração facial quadro a quadro com Video Face Enhancer. Se um clipe mostrar mais de três rostos ao mesmo tempo, os três maiores são restaurados e os demais ficam como estavam.
Compare o resultado com a origem
Assista à saída em velocidade normal e em um quadro pausado, e confira o áudio, a duração e a taxa de quadros, além dos rostos. A versão em imagem desta ferramenta deixou a pele um pouco mais lisa do que uma foto real, então procure o mesmo amolecimento nos rostos em movimento. O fundo não é tocado, então os blocos de compressão que existirem ali permanecem. Guarde o arquivo original.
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/face-enhancer-video-v1/video-edit",
"input": {
"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.
