Video Sound Effects API-Referenz

Mit einem einzigen PopNow-API-Schlüssel rufst du Video Sound Effects aus deinem eigenen Code auf. Hier findest du die Modell-IDs, jedes Eingabefeld, die Kosten pro Anfrage in Credits und eine Anfrage, die du direkt ins Terminal kopieren kannst.

Die Parameterbeschreibungen stammen aus dem Eingabeschema des Modells und sind nur auf Englisch verfügbar.

Auf einen Blick

Hersteller: PopNow
Ergebnis: Audio
Ab: 0.18 Credits pro Sekunde Ergebnis ($0.0018)
Modell-IDs: popnow/foley-v1/video-to-audio

1 Credit = 0,01 $. Bei Annahme reserviert ein Task den höchstmöglichen Betrag und rechnet am Ende den tatsächlichen Verbrauch ab, auf ganze Credits aufgerundet; der Rest wird freigegeben. Fehlgeschlagene Tasks kosten nichts. Den genauen Betrag vorab liefert POST /api/v1/jobs/quote.

Video zu Audio

popnow/foley-v1/video-to-audio

Preis

Option	Credits (pro Sekunde Ergebnis)	US-Dollar
`Standard`	0.18	$0.0018

Parameter

Feld	Typ	Standardwert	Erlaubt	Bedeutung
`video_url`Pflicht	`string`	—	—	Clip to add sound to. The picture is kept; the returned clip carries the generated sound as its audio.
`prompt`Optional	`string`	—	bis zu 1.000 Zeichen	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`Optional	`integer`	`8`	1 bis 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`Optional	`string`	—	bis zu 1.000 Zeichen	Sounds to keep out, such as music or speech.
`ignore_visual_semantics`Optional	`boolean`	`false`	—	Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion.
`guidance_scale`Optional	`number`	`4.5`	0 bis 20	How closely the sound follows the description, from 0 to 20.
`steps`Optional	`integer`	`25`	4 bis 50	Refinement passes, from 4 to 50. More passes take longer.

Beispielanfrage

Diese Anfrage läuft so, wie sie ist; weggelassene Felder behalten ihren Standardwert. Leg deinen Schlüssel vorher in POPNOW_API_KEY ab.

Das Beispiel nutzt in video_url Beispieldateien von PopNow. Ersetze sie durch eigene öffentliche HTTPS-Links, Uploads oder gespeicherte Assets.

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
  }
}'

Die Antwort enthält sofort eine taskId. Das Ergebnis holst du mit GET /api/v1/jobs/recordInfo ab – oder du gibst callBackUrl mit und wirst benachrichtigt.

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"