Introduction
Isolez le premier plan d’un clip existant et choisissez la transparence ou un fond uni. Par défaut, la requête demande un WebM VP9 transparent avec le son d’origine.
| Champ | Valeur |
|---|---|
| Entrée | Vidéo |
| Sortie | Vidéo |
Paramètres de requête
| Paramètre | Obligatoire | Description |
|---|---|---|
video_url | Oui | Clip source de 1 à 60 secondes. La sortie isole le premier plan détecté ; aucun réglage de recadrage n’est disponible. 1 caractères minimum |
background | Non | Choisissez la transparence ou l’une des dix couleurs unies. Une sortie transparente nécessite un format prenant en charge l’alpha. |
output_format | Non | Préréglage du conteneur et du codec. WebM VP9 est le format par défaut. |
keep_original_audio | Non | Demande d’inclure le son d’origine dans la sortie ; activé par défaut. Désactivez cette option pour un clip muet. Valeur par défaut: |
Tarification
$0.06 / seconde
Facturation par seconde de vidéo en entrée, avec arrondi à la seconde entière supérieure. Cet endpoint accepte les clips de 1 à 60 secondes. Le choix du fond, du format et du son ne change pas cette règle fondée sur 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
L’outil de suppression d’arrière-plan vidéo isole le premier plan d’une vidéo existante pour le compositing ou pour le placer sur un fond uni. Envoyez video_url, puis choisissez le fond et le format d’export. La requête par défaut demande un WebM VP9 transparent et conserve le son d’origine. Cet endpoint accepte les clips source de 1 à 60 secondes ; il ne génère pas de nouvelle scène à partir d’un prompt.
Fonctionnalités clés et points forts
La transparence dépend du choix du fond et du format
Réglez background sur transparent et utilisez un format prenant en charge l’alpha. WebM VP9, MOV ProRes 4444, MKV VP9 et GIF sont des options documentées pour l’alpha. Les préréglages MP4 et les préréglages MKV H.264 ou H.265 ne contiennent pas d’alpha ici ; les demandes de transparence incompatibles peuvent être rejetées. La prise en charge documentée de MOV H.265 n’est que partielle : utilisez donc WebM VP9 pour le flux de travail transparent par défaut et vérifiez la sortie réelle avant le compositing.
Couleurs unies et son d’origine
Vous pouvez aussi choisir le noir, le blanc, le gris, le rouge, le vert, le bleu, le jaune, le cyan, le magenta ou l’orange. keep_original_audio détermine si le son source est demandé dans le résultat. Le GIF ne peut pas contenir de piste audio ; désactivez la conservation du son lorsque vous le choisissez. Le choix du conteneur, du codec et du fond ne change pas la règle de facturation fondée sur la durée. La facturation utilise les secondes en entrée arrondies à l’entier supérieur, et cet endpoint ne propose aucun réglage de recadrage ou de résolution de sortie.
Cas d’utilisation
Superposer un présentateur à une présentation
Commencez par un clip court dans lequel le présentateur se détache clairement du fond. Demandez un WebM VP9 transparent, puis placez le résultat au-dessus de la diapositive ou de la scène dans un logiciel de montage prenant en charge ce format. Inspectez les cheveux et les contours présentant un flou de mouvement sur des fonds sombres et clairs avant de publier la composition.
Préparer un clip produit pour une nouvelle mise en page
Détourez un produit de son environnement d’origine pour réutiliser la séquence dans une mise en page de catalogue ou un montage destiné aux réseaux sociaux. Un export sur fond uni peut être utile lorsque la transparence n’est pas nécessaire. Les surfaces réfléchissantes et les contours fins nécessitent un examen attentif : le résultat est un masque traité, à évaluer sur le fond prévu plutôt que sur le seul aperçu en damier.
Guide des prompts et conseils pratiques
Choisir délibérément le format de livraison
Conservez background=transparent, output_format=webm_vp9 et keep_original_audio=true pour le flux de travail vidéo par défaut. Ne choisissez un autre préréglage qu’après avoir vérifié que votre logiciel de montage peut l’importer. La prise en charge de la lecture sur le Web varie selon le navigateur et le codec ; un téléchargement réussi ne prouve pas qu’un aperçu intégré ou un montage ultérieur fonctionnera. Conservez le master transparent lorsque vous créez un aperçu distinct aplati sur un fond pour le partager.
Vérifier la transparence et l’intégralité du clip
Inspectez le canal alpha réel et composez le résultat sur du noir, du blanc et une couleur saturée. Un fichier affichant un damier ou un rectangle noir ne prouve pas que la transparence fonctionne. Examinez l’ensemble du mouvement pour repérer les variations des contours, puis comparez la durée, les dimensions des images et la synchronisation audio avec l’original. Ne déduisez pas la présence d’alpha du nom du fichier ou des options choisies. Aucun essai de qualité des médias ou de compatibilité avec les navigateurs n’a encore été mené à terme pour cette intégration ; validez le résultat dans le flux de travail prévu.
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/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"
La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.
