Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
duration_seconds | Nein | Wie lang der Clip läuft. Abgerechnet wird pro Sekunde. ≥ 1 · ≤ 30 · Standardwert: 8 |
guidance_scale | Nein | Wie streng das Modell dem Prompt folgt. ≥ 0 · ≤ 20 · Standardwert: 4.5 |
ignore_visual_semantics | Nein | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Standardwert: false |
negative_prompt | Nein | Stile oder Klänge, die nicht im Track vorkommen sollen. |
prompt | Nein | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | Nein | Mehr Schritte bringen mehr Details, dauern aber länger. ≥ 4 · ≤ 50 · Standardwert: 25 |
video_url | Ja | Der Clip, der bearbeitet wird. |
Preise
Die Preise sind in Credits angegeben, denselben Credits, die du auf der Website nutzt (1 Credit = 0,01 $). Beim Annehmen der Aufgabe wird der Betrag reserviert und nach Abschluss auf die tatsächlichen Kosten abgerechnet; fehlgeschlagene Aufgaben werden erstattet.
| Option | Credits pro Sekunde | ≈ USD |
|---|---|---|
| Standard | 0,18 | 0,0018 $ |
Jede Aufgabe wird auf ganze Credits aufgerundet, ein Lauf in der günstigsten Stufe kostet also 1 Credit für einen 5-Sekunden-Clip (0,01 $).
Für eine exakte Zahl vor dem Start sendest du denselben Body an POST /jobs/quote.
API-Schnellstart
Die Video Sound Effects API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow- und nutzen dieselben Credits wie die Website.
- Anfrage senden. Sende POST /jobs/createTask mit model popnow/foley-v1/video-to-audio und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 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"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Video Sound Effects API
Was kostet die Video Sound Effects API?
Video Sound Effects kostet 1 Credit (0,01 $) für einen 5-Sekunden-Clip. Die Credits sind dieselben wie auf der Website (1 Credit = 0,01 $), neue Konten bekommen 30 Gratis-Credits, und fehlgeschlagene Tasks werden erstattet.
Wie lautet der Modellname von Video Sound Effects in der API?
Trag popnow/foley-v1/video-to-audio für Video zu Audio im Feld model von POST /jobs/createTask ein.
Muss ich den Ton beschreiben?
Nein. Ohne Beschreibung wird eine allgemeine Anfrage nach Geräuschen gesendet, die zur Handlung im Bild passen. Ein paar konkrete Worte bringen meist ein besseres Ergebnis.
Was passiert mit Ton, der schon im Clip ist?
Das gelieferte Video trägt die erzeugte Spur als Ton; beginnen Sie also mit einem stummen Clip oder einem, dessen Ton ersetzt werden soll.
Welche Limits hat die Video Sound Effects API?
Cliplänge: 1–30 s; Prompt-Länge (Zeichen): 1,000; Größter Upload: 90 MB. Anfragen außerhalb dieser Grenzen werden abgelehnt, bevor etwas abgebucht wird.
Kann ich Video Sound Effects testen, ohne Code zu schreiben?
Ja. Der Playground führt Video Sound Effects mit deinen PopNow-Credits aus, braucht keinen API-Schlüssel und zeigt dir zu jedem Lauf den passenden Code.