Da video ad audioInformazioni su Video Sound Effects
Dai il suono a una clip muta: lo strumento guarda l'immagine e genera effetti e ambiente che seguono l'azione, guidati da una descrizione facoltativa, fino a 30 secondi.
Lo chiami con il nome di modello popnow/foley-v1/video-to-audio su POST /jobs/createTask, da 1 credito per una clip di 5 secondi (0,01 USD). I nuovi account ricevono 30 crediti gratuiti per provarlo prima nel Playground.
Per ora questa guida è solo in inglese. →
Parametri della richiesta
| Parametro | Obbligatorio | Descrizione |
|---|---|---|
duration_seconds | No | Quanto dura la clip. Si paga al secondo. ≥ 1 · ≤ 30 · Predefinito: 8 |
guidance_scale | No | Quanto rigidamente il modello segue il prompt. ≥ 0 · ≤ 20 · Predefinito: 4.5 |
ignore_visual_semantics | No | Choose the sounds from the prompt alone instead of from what the picture shows; timing still follows the motion. Predefinito: false |
negative_prompt | No | Stili o suoni che non vuoi nel brano. |
prompt | No | The sounds you want, as a short list. If omitted, a general request for sounds that match the on-screen action is used. |
steps | No | Più passaggi aggiungono dettaglio ma richiedono più tempo. ≥ 4 · ≤ 50 · Predefinito: 25 |
video_url | Sì | La clip su cui lavorare. |
Prezzi
I prezzi sono in crediti, gli stessi che usi sul sito (1 credito = 0,01 $). L'importo viene trattenuto quando il task è accettato e regolato sul costo reale al termine; i task falliti vengono rimborsati.
| Opzione | Crediti al secondo | ≈ USD |
|---|---|---|
| Standard | 0,18 | 0,0018 USD |
Ogni attività è arrotondata per eccesso ai crediti interi, quindi un'esecuzione al livello più basso costa 1 credito per una clip di 5 secondi (0,01 USD).
Per avere la cifra esatta prima di eseguire, invia lo stesso body a POST /jobs/quote.
Guida rapida all'API
Chiama l'API di Video Sound Effects in tre passaggi
- Crea una chiave API. Accedi a PopNow e crea una chiave nella console API. Le chiavi iniziano con sk-popnow- e usano gli stessi crediti del sito.
- Invia la richiesta. Invia POST /jobs/createTask con model popnow/foley-v1/video-to-audio e un oggetto input secondo la tabella dei parametri. La risposta restituisce subito un ID attività.
- Recupera il risultato. Interroga GET /jobs/recordInfo con l'ID attività, oppure passa una callBackUrl e ti inviamo lì il risultato. Scarica i link di output quando l'attività riesce.
# 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"Sostituisci il prompt e gli eventuali link con i tuoi. La scheda API contiene il riferimento per risposta, polling e callback.
Domande sull’API di Video Sound Effects
Quanto costa l’API di Video Sound Effects?
Video Sound Effects costa 1 credito (0,01 USD) per una clip di 5 secondi. I crediti sono gli stessi del sito (1 credito = 0,01 $), i nuovi account ricevono 30 crediti gratuiti e i task falliti vengono rimborsati.
Qual è il nome del modello di Video Sound Effects nell’API?
Inserisci popnow/foley-v1/video-to-audio per Da video ad audio nel campo model di POST /jobs/createTask.
Devo descrivere il suono?
No. Senza descrizione viene inviata una richiesta generica di suoni adatti all'azione a schermo. Poche parole precise di solito danno un risultato migliore.
Che fine fa il suono già presente nella clip?
Il video consegnato porta la traccia generata come audio, quindi parti da una clip muta o da una di cui vuoi sostituire il suono.
Quali sono i limiti dell’API di Video Sound Effects?
Durata della clip: 1–30 s; Lunghezza del prompt (caratteri): 1,000; Caricamento massimo: 90 MB. Le richieste fuori da questi limiti vengono rifiutate prima di qualsiasi addebito.
Posso provare Video Sound Effects senza scrivere codice?
Sì. Il Playground esegue Video Sound Effects con i tuoi crediti PopNow, non richiede una chiave API e mostra il codice di ogni generazione.