À propos de Video Background Remover
Un master vidéo transparent pour votre prochaine composition.
Appelez-le avec le nom de modèle popnow/background-remover-video-v1/video-edit sur POST /jobs/createTask, à partir de 0,06 $US.
Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
background | Non | Garder, supprimer ou remplacer l’arrière-plan. transparent · black · white · gray · red · green · blue · yellow · cyan · magenta · orange · Par défaut: transparent |
keep_original_audio | Non | Keep the source audio in an output format that supports audio. GIF does not carry sound. Par défaut: true |
output_format | Non | Le type de fichier du résultat. webm_vp9 · mp4_h264 · mp4_h265 · mov_h265 · mov_proresks · mkv_h264 · mkv_h265 · mkv_vp9 · gif · Par défaut: webm_vp9 |
video_url | Oui | Le clip à traiter. |
Tarifs
Les prix sont en USD. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.
| Option | USD par seconde en entrée |
|---|---|
| Standard | 0,06 $US |
La durée d’entrée est arrondie à la seconde supérieure, avec un minimum de 1 secondes.
Avant l’exécution, envoyez le même corps de requête à POST /jobs/quote pour connaître les frais estimés et leur plafond en USD. Le devis ne lance aucune tâche et ne débite pas votre solde.
Démarrage rapide de l'API
Appeler l’API Video Background Remover en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow-. Les appels API utilisent votre solde distinct en dollars américains.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/background-remover-video-v1/video-edit et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/background-remover-video-v1/video-edit",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Video Background Remover
Combien coûte l’API Video Background Remover ?
Video Background Remover coûte 0,06 $US par seconde. L’API utilise un solde distinct en dollars américains. Les crédits du site ne peuvent pas être utilisés pour l’API ni convertis en solde API, et le solde API ne peut pas être converti en crédits du site. À l’acceptation d’une tâche, le montant maximal du devis est réservé sur votre solde API. À la fin, la facturation suit l’usage réel, sans dépasser ce montant, et le reste est libéré. En cas d’échec, le montant réservé est libéré.
Quel est le nom de modèle de Video Background Remover dans l’API ?
Indiquez popnow/background-remover-video-v1/video-edit pour Retirer le fond de la vidéo dans le champ model de POST /jobs/createTask.
Quels réglages permettent de demander une sortie transparente ?
Utilisez background=transparent avec output_format=webm_vp9. Conservez le master alpha obtenu pour le compositing et vérifiez le canal réel avant utilisation.
La conservation du son s’applique-t-elle au GIF ?
Non. Le GIF n’a pas de piste audio. Désactivez keep_original_audio lorsque vous demandez un GIF.
Puis-je supposer que le résultat fonctionne dans tous les navigateurs ?
Non. La prise en charge des conteneurs et des codecs varie. Vérifiez la lecture et le montage dans le navigateur ou l’application où le résultat sera utilisé.
Quelles sont les limites de l’API Video Background Remover ?
Durée maximale du clip d’entrée: 60 s. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Video Background Remover sans écrire de code ?
Exécutez Video Background Remover dans le Playground avec votre solde API en USD, sans clé API. Chaque exécution figure dans votre historique développeur avec le code correspondant.