Introduction
Ce que fait cet endpoint
Il prend une vidéo et renvoie une copie dans laquelle jusqu’à trois visages par image, du plus grand au plus petit, sont restaurés et rendus plus nets. Le résultat reste stable d’une image à l’autre. Le mouvement, le cadrage, la durée et la piste audio d’origine sont conservés, et la résolution ne change pas. Il n’y a pas de prompt.
Les entrées qui comptent
video_url est le clip : un fichier MP4 envoyé ou une URL publique, d’une durée de 3 secondes à 5 minutes. Les clips hors de cette plage sont refusés avant toute facturation. Choisissez pour Video Face Enhancer un vrai visage bien visible et assez grand dans la source ; la restauration des visages image par image avec Video Face Enhancer profite davantage de ces détails que d’un visage lointain ou masqué.
Ce que vous recevez
Une vidéo par requête, à la résolution, à la fréquence d’images et à la durée que vous avez envoyées, avec votre audio, servie depuis le stockage de la plateforme une fois la tâche terminée. Pour plus de pixels, utilisez /models/video-upscaler-v1.
| Champ | Valeur |
|---|---|
| Entrée | Vidéo |
| Sortie | Vidéo |
| Endpoint | Édition vidéo |
| Visages | Jusqu’à trois par image, du plus grand au plus petit |
| Réglages | Aucun prompt — le clip est toute la requête |
| Facturation | À la seconde du clip d’entrée, minimum 3 secondes |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Le clip à restaurer : un fichier MP4 envoyé ou un lien public, d’une durée de 3 secondes à 5 minutes. Les clips hors de cette plage sont refusés avant toute facturation. 1 caractères minimum |
Tarification
$0.012 / seconde produite
Facturation à la seconde du clip d’entrée, arrondie à la seconde supérieure, avec une durée minimale facturée de 3 secondes. Jusqu’à la livraison, un fichier envoyé est réservé sur sa propre durée et une URL sur la durée maximale de 5 minutes ; la différence est alors libérée. Une requête échouée n’est pas facturée.
Cas d’utilisation
Clips de podcast et d’interview
Les vidéos de personne qui parle face caméra, très compressées pour l’envoi, perdent d’abord du détail au niveau du visage. Passez-les une fois pour retrouver les yeux, les dents et la ligne de cheveux, pendant que la pièce, le cadrage et le son restent identiques.
Vidéos anciennes ou trop compressées
Les clips enregistrés, partagés et réencodés plusieurs fois paraissent flous et en blocs autour du visage. Jusqu’à trois visages par image sont restaurés : un clip avec une ou deux personnes bien visibles est donc le cas idéal.
Vidéo que vous comptez agrandir plus tard
Commencez par nettoyer les visages, puis utilisez Video Upscaler sur /models/video-upscaler-v1 si le clip a aussi besoin de plus de pixels pour un écran plus grand.
Guide de prompt et conseils pratiques
Vérifiez le clip
Un MP4 d’une durée comprise entre 3 secondes et 5 minutes, avec des visages humains réels, d’assez grande taille et bien visibles. Découpez-le d’abord à la partie dont vous avez besoin.
Envoyez
video_urlvideo_urlest un fichier MP4 envoyé ou un lien public. C’est le seul champ : il n’y a pas de prompt et rien à régler.Interrogez, puis comparez
L’appel est asynchrone : créez la tâche, interrogez-la jusqu’à ce qu’elle soit terminée, puis téléchargez la vidéo depuis le stockage de la plateforme. Comparez-la avec la source à vitesse normale et sur une image figée, et vérifiez que l’audio est intact.
Introduction
Video Face Enhancer restaure et rend plus nets les visages de chaque image d’un clip. Vous envoyez video_url ; l’outil repère jusqu’à trois visages par image, du plus grand au plus petit, et reconstitue les détails que la forte compression ou le flou ont fait disparaître, en gardant le résultat stable d’une image à l’autre. Le mouvement, le cadrage, la durée et la piste audio d’origine restent tels quels, et le clip revient à la résolution que vous avez envoyée. Les clips acceptés sont des fichiers MP4 de 3 secondes à 5 minutes, et il n’y a pas de prompt.
Principales fonctionnalités et points forts
Des visages nettoyés sur chaque image
La restauration porte sur tout le clip, et non sur une image fixe. Dans notre test, nous avons pris un clip de 5 secondes en 640×360 d’une animatrice de podcast et l’avons dégradé par une forte compression H.264. Il est revenu en 640×360 et 24 fps, toujours long de 5,0 secondes, après environ 21 secondes de traitement. Les yeux, les dents et la ligne de cheveux étaient plus nets sur chaque image et ne scintillaient pas, et l’animatrice restait reconnaissable comme la même personne.
Le reste ne change pas
L’audio, le mouvement, le cadrage et la durée sont conservés, et la zone autour des visages reste intacte : la pièce derrière l’animatrice était inchangée. L’outil n’agrandit pas la vidéo. Si vous avez aussi besoin de plus de pixels, utilisez Video Upscaler (/models/video-upscaler-v1).
La facturation suit la durée du clip
La facturation se fait à la seconde du clip d’entrée, arrondie à la seconde supérieure, avec une durée minimale facturée de 3 secondes. Les clips de moins de 3 secondes ou de plus de 5 minutes sont refusés avant toute facturation. Lorsque le clip est un fichier envoyé dont la durée peut être lue, la réservation porte sur cette durée ; pour une URL, le devis reste sur la durée maximale de 5 minutes jusqu’à la livraison, puis la différence est libérée. Une requête échouée n’est pas facturée.
Cas d’utilisation
Clips de podcast et d’interview
Les vidéos de personne qui parle face caméra, très compressées pour l’envoi, perdent d’abord du détail au niveau du visage. Passez le clip une fois pour retrouver les yeux, les dents et la ligne de cheveux, pendant que la pièce, le cadrage et le son restent identiques.
Vidéos anciennes ou trop compressées
Les clips enregistrés, partagés et réencodés plusieurs fois paraissent flous et en blocs autour du visage. Jusqu’à trois visages par image sont restaurés, du plus grand au plus petit : un clip avec une ou deux personnes bien visibles est donc le cas le plus adapté.
Vidéo que vous comptez agrandir plus tard
Nettoyez d’abord les visages, puis utilisez Video Upscaler (/models/video-upscaler-v1) si le clip a aussi besoin de plus de pixels pour un écran plus grand.
Guide des prompts et conseils pratiques
Pas de prompt : choisissez le clip
La seule entrée est video_url, un fichier MP4 envoyé ou un lien public, d’une durée de 3 secondes à 5 minutes. Découpez le clip à la partie dont vous avez besoin avant de l’envoyer, car la facturation suit la durée de ce que vous envoyez.
Choisissez des visages qui peuvent être restaurés
Choisissez pour Video Face Enhancer un vrai visage bien visible et assez grand dans la source ; la restauration des visages image par image avec Video Face Enhancer profite davantage de ces détails que d’un visage lointain ou masqué. Video Face Enhancer dispose de moins d’indices si la source est dessinée ou si le visage est minuscule, masqué ou très flou, ce qui limite la restauration des visages image par image avec Video Face Enhancer. Si un clip montre plus de trois visages à la fois, les trois plus grands sont restaurés et les autres restent tels quels.
Comparez le résultat avec la source
Regardez la sortie à vitesse normale et sur une image figée, et vérifiez l’audio, la durée et la fréquence d’images en plus des visages. La version image de cet outil laissait la peau un peu plus lisse qu’une vraie photo : cherchez le même lissage sur les visages en mouvement. L’arrière-plan n’est pas modifié, donc les éventuels blocs de compression qui s’y trouvent restent. Gardez le fichier source.
Démarrage rapide de l’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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
