Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
duration_seconds | Non | La durée du clip. Facturée à la seconde. ≥ 1 · ≤ 30 · Par défaut: 8 |
guidance_scale | Non | À quel point le modèle suit le prompt à la lettre. ≥ 0 · ≤ 20 · Par défaut: 4.5 |
ignore_visual_semantics | Non | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Par défaut: false |
negative_prompt | Non | Les styles ou sons que vous ne voulez pas dans le morceau. |
prompt | Non | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | Non | Plus d’étapes ajoutent du détail mais prennent plus de temps. ≥ 4 · ≤ 50 · Par défaut: 25 |
video_url | Oui | Le clip à traiter. |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par seconde | ≈ USD |
|---|---|---|
| Standard | 0,18 | 0,0018 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 1 crédit pour un clip de 5 secondes (0,01 $US).
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API Video Sound Effects 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- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model popnow/foley-v1/video-to-audio 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/foley-v1/video-to-audio",
"input": {
"video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
"duration_seconds": 8
}
}'
# 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 Sound Effects
Combien coûte l’API Video Sound Effects ?
Video Sound Effects coûte 1 crédit (0,01 $US) pour un clip de 5 secondes. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de Video Sound Effects dans l’API ?
Indiquez popnow/foley-v1/video-to-audio pour Vidéo vers audio dans le champ model de POST /jobs/createTask.
Faut-il décrire le son ?
Non. Sans description, une demande générale de sons correspondant à l'action à l'écran est envoyée. Quelques mots précis donnent en général un meilleur résultat.
Que devient le son déjà présent dans le clip ?
La vidéo livrée porte la piste générée comme son : partez d'un clip muet ou d'un clip dont vous voulez remplacer le son.
Quelles sont les limites de l’API Video Sound Effects ?
Durée du clip: 1–30 s; Longueur du prompt (caractères): 1,000; Taille maximale d’envoi: 90 MB. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Video Sound Effects sans écrire de code ?
Oui. Le Playground lance Video Sound Effects avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.