Référence API de Video Sound Effects

Une seule clé API PopNow suffit pour appeler Video Sound Effects depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: PopNow
Résultat: Audio
À partir de: 0.18 crédits par seconde produite ($0.0018)
Identifiants de modèle: popnow/foley-v1/video-to-audio

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Vidéo vers audio

popnow/foley-v1/video-to-audio

Prix

Option	Crédits (par seconde produite)	Dollars US
`Par défaut`	0.18	$0.0018

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`video_url`Obligatoire	`string`	—	—	Clip to add sound to. The picture is kept; the returned clip carries the generated sound as its audio.
`prompt`Facultatif	`string`	—	jusqu’à 1 000 caractères	The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used.
`duration_seconds`Facultatif	`integer`	`8`	de 1 à 30	Seconds of sound to generate, from 1 to 30. The returned clip is cut to this length and these seconds are billed.
`negative_prompt`Facultatif	`string`	—	jusqu’à 1 000 caractères	Sounds to keep out, such as music or speech.
`ignore_visual_semantics`Facultatif	`boolean`	`false`	—	Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion.
`guidance_scale`Facultatif	`number`	`4.5`	de 0 à 20	How closely the sound follows the description, from 0 to 20.
`steps`Facultatif	`integer`	`25`	de 4 à 50	Refinement passes, from 4 to 50. More passes take longer.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "popnow/foley-v1/video-to-audio",
  "input": {
    "prompt": "Soft wind, rustling petals and distant birdsong",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 8
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"