Introduzione
Video Sound Effects aggiunge una traccia sonora a una clip guardandola. Invia il girato in video_url, descrivi se vuoi in prompt cosa si deve sentire e scegli con duration_seconds quanti secondi di suono generare. Lo strumento genera effetti e ambiente che seguono l'azione a schermo e restituisce la stessa immagine con quella traccia come audio.
Caratteristiche principali
Un suono che segue l'immagine
La traccia è generata dai fotogrammi, quindi urti, passi, liquidi versati e traffico che passa cadono dove accadono nell'inquadratura, non su un loop steso sopra. Una breve descrizione orienta la tavolozza, dalla pioggia sul vetro alla ghiaia sotto i piedi fino a una cucina in piena attività, e il prompt negativo tiene fuori ciò che non vuoi, come musica o voci.
Durata a scelta, prezzo prevedibile
La durata richiesta va da uno a trenta secondi e stabilisce sia quanto dura la clip consegnata sia quanto costa: paghi i secondi che chiedi, non il tempo di elaborazione. L'immagine in sé non cambia, quindi inquadratura e risoluzione restano esattamente quelle della clip inviata.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
video_url | Sì | La clip a cui dare il suono. L'immagine resta com'è. almeno 1 caratteri |
prompt | No | I suoni che vuoi, in una lista breve: pioggia su una finestra, traffico lontano, passi sulla ghiaia. almeno 1 caratteri · al massimo 1000 caratteri |
duration_seconds | No | Quanti secondi di suono generare, da 1 a 30. |
negative_prompt | No | I suoni da escludere, come musica, voci o rumore del vento. al massimo 1000 caratteri |
ignore_visual_semantics | No | Disattivato di default: il modello decide cosa far sentire in base all’immagine e al tuo prompt. Predefinito: |
guidance_scale | No | Quanto il suono segue la tua descrizione, da 0 a 20. Il valore predefinito va bene per la maggior parte delle clip; alzalo un po' se il risultato ignora il prompt. |
steps | No | Passaggi di rifinitura, da 4 a 50. Più passaggi richiedono più tempo; il valore predefinito è un buon equilibrio. |
Prezzi
$0.0012 / secondo generato
Addebito per secondo di suono richiesto con duration_seconds, non in base alla durata della clip.
Casi d’uso
Rifinire le clip dei modelli video
La maggior parte dei video generati arriva muta. Aggiungere ambiente ed effetti prima di pubblicare rende la clip finita senza passare da una libreria di suoni né da una sessione di montaggio, e le clip brevi di solito tornano in meno di un minuto.
Audio provvisorio per montaggi e riprese di prodotto
Una bozza che scorre in silenzio è difficile da giudicare. Dai ai primi montaggi, alle clip di cibo e ai loop di prodotto una base sonora credibile, e sostituiscila più avanti se la scena richiede musica.
Consigli avanzati
Descrivi le fonti, non le atmosfere
Elenca ciò che fa rumore: il sibilo della macchina dell'espresso, tazzine che tintinnano e un leggero brusio da bar funzionano meglio di un'atmosfera accogliente. Tre o quattro fonti bastano; le liste lunghe si impastano.
Allinea la durata alla clip
Imposta duration_seconds sulla durata della clip, arrotondando per eccesso. Se chiedi di più paghi secondi che non compaiono mai, perché il video consegnato si ferma dove finisce la clip; se chiedi di meno il video viene tagliato a quanto richiesto.
All'inizio lascia stare i controlli fini
guidance_scale stabilisce quanto il suono segue le tue parole e steps il numero di passaggi di rifinitura; i valori predefiniti vanno bene per la maggior parte delle clip. Alza un po' la guidance solo quando il risultato ignora il prompt, e aspettati che più passaggi allunghino i tempi più che migliorare di molto il suono.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "spicyapi/foley-v1/video-to-audio",
"input": {
"duration_seconds": 8,
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
