Introduction
Effacez une zone fixe sur toute la vidéo à l’aide d’un masque d’image blanc sur fond noir. Une instruction facultative décrit la suppression locale ; le même masque s’applique à l’ensemble du clip.
| Champ | Valeur |
|---|---|
| Entrée | Vidéo |
| Sortie | Vidéo |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | La vidéo complète à traiter, d’une durée de 1 à 600 secondes. La zone sélectionnée est traitée sur tout le clip. 1 caractères minimum |
mask_url | Oui | Une image PNG statique alignée sur l’image vidéo. Peignez la zone à supprimer en blanc et le reste en noir. 1 caractères minimum |
prompt | Non | Instructions facultatives pour la suppression locale. Elles ne sélectionnent pas d’intervalle de temps et n’activent pas le suivi. |
Tarification
$0.024 / seconde
Facturation sur l’ensemble du clip d’entrée, avec un arrondi à la seconde supérieure et une durée minimale facturée de 3 secondes. Cet endpoint accepte les clips de 1 à 600 secondes ; la taille du masque ne réduit pas la durée.
Cas d’utilisation
Vidéo → Édition vidéo → Vidéo
Édition vidéo
Vidéo
Tâche asynchrone
Guide de prompt et conseils pratiques
Introduction
Video Eraser supprime le contenu situé dans un masque d’image statique sur l’ensemble d’un clip vidéo. Envoyez video_url et mask_url, avec éventuellement un court prompt décrivant la suppression. Il convient à une bande de sous-titres fixe ou à un autre élément indésirable qui reste dans la même zone de l’écran. Le fond obtenu est un remplissage déduit, et non une récupération des pixels d’origine cachés.
Principales fonctionnalités et points forts
Une zone fixe pour tout le clip
Le masque est une image fixe : le blanc désigne la zone à effacer, et le noir la zone à conserver. La même zone de l’écran s’applique sur toute la vidéo fournie. Il n’y a ni champ d’heure de début, ni champ d’heure de fin, ni commande de suivi d’objets en mouvement. Un sous-titre qui sort de la zone blanche n’est pas couvert par ce masque. Le contenu qui traverse la zone sélectionnée peut également être modifié par le remplissage.
Une description facultative en complément du masque
Une brève description peut préciser ce qui doit être supprimé et ce qui l’entoure. Le masque reste obligatoire sur cet endpoint afin de délimiter explicitement la zone. Le traitement est facturé sur la totalité du clip d’entrée, avec un arrondi à la seconde supérieure et une durée minimale facturée de 3 secondes. Les clips source acceptés durent de 1 à 600 secondes. Un masque plus petit ne réduit pas la durée vidéo facturée.
Cas d’utilisation
Supprimer une bande de sous-titres fixe
Pour des sous-titres déjà incrustés dans vos propres images, délimitez la bande de sous-titres et examinez chaque passage où du texte apparaît. Un arrière-plan statique constitue un bon point de départ pour vérifier le résultat. Si les sous-titres sont encore des calques de texte modifiables dans le projet, supprimez directement ces calques avant d’opter pour la reconstruction des pixels.
Nettoyer une incrustation immobile
Utilisez un masque ajusté pour une incrustation indésirable dans un coin des images que vous montez. Vérifiez les images où une personne ou un produit passe derrière la zone sélectionnée, ou lorsqu’un mouvement de caméra modifie ce qui se trouve derrière cette zone. Dans ces moments, le remplissage doit déduire un contenu changeant, ce qui peut révéler des scintillements ou des contours déformés peu visibles sur une seule image d’aperçu.
Guide des prompts et conseils pratiques
Créer un masque sans ambiguïté
Préparez un masque PNG aligné sur l’image source : blanc à l’intérieur de la zone à supprimer, noir à l’extérieur. Vérifiez son positionnement sur la première image, celle du milieu et la dernière avant l’envoi. Évitez les zones blanches inutilement grandes, surtout lorsqu’elles recouvrent un visage ou un détail important d’un produit. Le masque est statique et agit sur tout le clip ; il ne peut ni suivre des sous-titres en mouvement ni limiter la modification à un intervalle de temps sélectionné.
Décrire la modification locale et comparer le résultat
Une instruction facultative telle que « Supprimer la bande de sous-titres fixe et la remplir avec l’arrière-plan environnant » décrit le changement souhaité sans inventer une nouvelle scène. Comparez la sortie à l’original à vitesse de lecture normale, puis image par image autour des mouvements difficiles à traiter. Vérifiez aussi les zones non masquées, la durée du clip, la fréquence d’images et le son, en plus de la zone effacée. La conservation de l’audio d’origine et la préservation exacte des pixels hors du masque n’ont pas été vérifiées ; conservez donc 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/video-eraser-v1/video-edit",
"input": {
"mask_url": "https://example.com/reference.png",
"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.