ElevenLabs
ElevenLabs Sound Effects
elevenlabs/sound-effects-v3
La serie di effetti sonori generati da testo di ElevenLabs: basta descrivere a parole l'azione, la scena e l'atmosfera per generare effetti sonori, con durata, loop continuo e grado di aderenza al prompt impostabili; ideale per effetti sonori di videogiochi, foley per la previsualizzazione cinematografica e basi atmosferiche
Prova elevenlabs/sound-effects-v3
Input
Creazioni
Vedi tutte le creazioniOutput
Prezzi
elevenlabs/sound-effects-v3 per second
| Prezzo unitario | $0.0029 |
|---|
Panoramica
Modello audio che genera effetti sonori a partire da una descrizione testuale, con la possibilità di specificare tramite prompt azioni, ambienti, atmosfere e modalità di espressione. Gli input comprendono una descrizione sonora obbligatoria e la durata; è inoltre possibile scegliere se attivare il loop senza interruzioni e il grado di influenza del prompt. Ideale per team di sviluppo di videogiochi, post-produzione audiovisiva, produzione di video brevi e prodotti interattivi, per ottenere rapidamente brevi effetti sonori pronti all'uso nei progetti.
Punti di forza principali
- Prompt fino a 450 caratteri — descrivi azione, scena e atmosfera in una frase, con un limite di 450 caratteri, spazio espressivo sufficiente a coprire dettagli sonori piuttosto fini.
- Durata impostabile da 0,5 a 30 secondi — specifica i secondi necessari a ogni richiesta, coprendo le lunghezze tipiche dei materiali, dai brevi suoni di clic fino a mezzo minuto di suoni ambientali.
- Supporto all'output in loop senza interruzioni — attivando il loop senza interruzioni si generano effetti sonori con inizio e fine che si raccordano, adatti a sfondi o suoni meccanici da riprodurre in modo continuo.
- Grado di influenza del prompt regolabile — controlla l'aderenza con un valore da 0 a 1: valori bassi danno risultati più variabili, valori alti più fedeli alla descrizione.
Descrizione delle capacità
Generazione di effetti sonori da descrizione testuale: invia una descrizione sonora di azione, scena, atmosfera e modalità di espressione; il modello restituisce l'audio corrispondente. La descrizione è obbligatoria e non può contenere solo spazi bianchi; massimo 450 caratteri.
Durata personalizzata dell'effetto sonoro: a ogni richiesta va specificata una durata da 0,5 a 30 secondi; la durata automatica non è supportata, e sia gli effetti brevi sia i suoni ambientali più lunghi rientrano nello stesso insieme di parametri.
Opzione loop senza interruzioni: attivando il loop senza interruzioni si generano effetti sonori adatti alla riproduzione continua; disattivandolo l'output è un normale effetto sonoro singolo.
Regolazione dell'aderenza al prompt: tramite il parametro di influenza del prompt da 0 a 1 si bilanciano variabilità e aderenza del risultato; 0 è più libero, 1 segue più rigorosamente la descrizione; il valore predefinito è 0,3.
Casi d'uso
- Team di sviluppo di videogiochi per effetti sonori di feedback interattivo — inserisci descrizioni di azioni come clic su pulsanti o attivazione di abilità e imposta una durata breve per ottenere materiali audio inseribili direttamente negli eventi di gioco.
- Post-produzione audiovisiva per integrare suoni ambientali — genera suoni ambientali di una decina di secondi con descrizioni di scena e atmosfera e inseriscili nella timeline di montaggio come sottofondo o effetto di transizione.
- Creatori di video brevi per aggiungere effetti sonori — descrivi in base al contenuto visivo effetti brevi come transizioni o segnali, entro uno o due secondi, per la traccia effetti nel software di montaggio.
- Design di prodotti interattivi per suoni di sottofondo in loop — attiva il loop senza interruzioni e specifica la durata per generare suoni meccanici o ambientali riproducibili in continuo, utili per il feedback sonoro in demo e prototipi.
Limiti e consigli per la scelta
Il prompt è limitato a 450 caratteri; se si supera occorre sintetizzare. A ogni richiesta va specificata una durata da 0,5 a 30 secondi; la durata automatica non è supportata. Se la descrizione è troppo breve o il parametro di influenza tende alla variazione, il risultato può differire dalle aspettative ed è necessario provare più volte e selezionare. L'output è audio di effetti sonori, non adatto a compiti che richiedono arrangiamenti musicali completi o canto vocale.
Domande frequenti
Vedi tutte le domande →-
Qual è la durata massima degli effetti sonori che questo modello può generare?
La durata massima supportata varia tra la versione attuale e quella precedente. elevenlabs/sound-effects-v3 consente di impostare da 0,5 a 30 secondi per singola generazione, mentre elevenlabs/sound-effects-v2 va da 0,5 a 22 secondi; in entrambi i casi è obbligatorio passare esplicitamente duration_seconds, la durata automatica non è supportata.
-
Come posso rendere i risultati generati più vicini alla mia descrizione?
Basta aumentare prompt_influence, che controlla il grado di aderenza al prompt. Il valore va da 0 a 1, con default 0.3; più si avvicina a 1, più la generazione segue rigorosamente la descrizione letterale, più si avvicina a 0, più è permissiva e produce maggiori variazioni, adatta a scenari che richiedono creatività inaspettata.
-
Come si scrive un prompt per effetti sonori che produca buoni risultati?
Si consiglia di organizzare il tutto secondo i quattro elementi «azione, ambiente, atmosfera, esecuzione», scrivendo un unico paragrafo descrittivo continuo. Ad esempio, scrivi prima quale azione produce il suono, poi in quale scena avviene e se l'atmosfera generale è tesa o silenziosa, infine aggiungi dettagli esecutivi come timbro o ritmo; mantieni l'intero paragrafo entro 450 caratteri. La v3 segue con maggiore stabilità i prompt che contengono più istruzioni: separare bene gli elementi è più efficace che accumulare sinonimi.
-
Come si generano gli effetti sonori in loop?
Impostando loop su true, viene generato un effetto sonoro riproducibile in loop senza interruzioni. Il risultato non presenta punti di inizio e fine percepibili, ed è adatto per suoni d'atmosfera, texture ambientali e basi sonore di lunga durata; il valore predefinito è false, ovvero viene generato un normale effetto sonoro con inizio e fine.
Crea un'attività di generazione
https://api.hiapi.ai/v1/tasks Header
AuthorizationstringObbligatorioChiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API
Content-TypestringOpzionaleIl corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.
Idempotency-KeystringOpzionaleChiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.
In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.
Corpo
modelstringObbligatorioValore fisso attuale: elevenlabs/sound-effects-v3
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per elevenlabs/sound-effects-v3 e la route default — vedi la tabella dei parametri sotto.
loopbooleanOpzionalePredefinito: falseControlla se generare un effetto sonoro riproducibile in loop senza interruzioni, valore booleano, predefinito false (nessun loop).
promptstringObbligatoriominLength 1maxLength 450pattern \STesto che descrive l'effetto sonoro desiderato, deve includere azione, scenario, atmosfera e modalità di espressione, lunghezza massima 450 caratteri.
duration_secondsnumberObbligatorioPredefinito: 2min 0.5max 30Durata dell'effetto sonoro generato, in secondi, intervallo di valori da 0,5 a 30, predefinito 2; la durata automatica non è supportata.
prompt_influencenumberOpzionalePredefinito: 0.3min 0max 1Controlla quanto il risultato generato aderisce al prompt: un valore di 0 è più casuale e variabile, 1 è più strettamente fedele alla descrizione, predefinito 0,3.
callbackobjectOpzionale
Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.
Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.
urlstringObbligatorioObbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.
whenstringOpzionalePredefinito: "final"Al momento è supportato solo final: notifica sia su success sia su fail.
finalstoragestringOpzionalePredefinito: "temp"Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.
temppersistentEsempi di richiesta
# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
-H "Authorization: Bearer $HIAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}' const res = await fetch("https://api.hiapi.ai/v1/tasks", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "elevenlabs/sound-effects-v3",
input: {
"loop": false,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
}),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } } import os, requests
res = requests.post(
"https://api.hiapi.ai/v1/tasks",
headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
json={
"model": "elevenlabs/sound-effects-v3",
"input": {
"loop": False,
"prompt": "…",
"duration_seconds": 2,
"prompt_influence": 0.3
}
},
)
print(res.json()) # { code, message, data: { taskId } } 200 OK
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
}
} 400 Bad Request
{
"code": 400,
"message": "invalid request",
"data": null,
"error_code": "INVALID_REQUEST"
} Ottieni i dettagli dell'attività
https://api.hiapi.ai/v1/tasks/:id Campi della risposta
taskIdstringObbligatorioID attività, sempre con prefisso tk-hiapi-.
modelstringObbligatorioNome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.
routestringOpzionalePresente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.
statusstringObbligatorioStato dell'attività.
queued In coda, non avviata.
handling In elaborazione.
archiving Elaborazione conclusa, preparazione artefatti.
success Terminale: completato, artefatti disponibili (restituisce output).
fail Terminale: errore (restituisce error).
Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.
creatednumberObbligatorioIstante di creazione dell'attività (secondi Unix).
completednumberObbligatorioSecondi Unix dello stato terminale; 0 finché non terminale.
outputarrayOpzionale
Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).
Array [ object ]
Elementi dell'array
urlstringObbligatorioURL dell'artefatto, scaricabile direttamente.
typestringObbligatorioValori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.
expireAtnumberObbligatorioSecondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.
errorobjectOpzionale
Presente solo con status == fail.
codestringObbligatorioCodice errore di business.
messagestringObbligatorioDescrizione dell'errore.
Esempi di risposta
Successo
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
"model": "happyhorse-1-0",
"status": "success",
"created": 1777282033,
"completed": 1777282099,
"output": [
{
"url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
"type": "video",
"expireAt": 1777886899
}
]
}
} In elaborazione (non terminale)
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "archiving",
"created": 1777282033,
"completed": 0
}
} Non riuscito
{
"code": 200,
"message": "success",
"data": {
"taskId": "tk-hiapi-...",
"model": "happyhorse-1-0",
"status": "fail",
"created": 1777282033,
"completed": 1777282099,
"error": {
"code": "TASK_FAILED",
"message": "task failed"
}
}
} Articoli
Vedi tutti gli articoli →-
Guida all'uso
ElevenLabs Sound Effects v3 effetti sonori in loop: dalla base sonora stabile alla verifica delle giunzioni
-
Guida all'uso
Come scrivere i prompt di ElevenLabs Sound Effects v3: organizzare la descrizione degli effetti sonori con materiale, azione e distanza
-
Guida all'uso
ElevenLabs Sound Effects v3 API: effetti sonori da 30 secondi, loop senza interruzioni e migrazione da v2
Prezzo, parametri, esempi di richiesta e come scrivere i prompt, tutto in un unico articolo
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
MiniMax Music 2.6 MiniMax $0.210 /brano -
MiniMax Music 1.5 MiniMax $0.070 /brano -
Mirelo SFX 2.0 Mirelo AI $0.021 /secondo -
Mureka 9.5 Mureka $0.322 per request -
MiniMax Music 3 MiniMax $0.0026 /secondo -
Lyria 3 Pro Google $0.140 /brano -
ElevenLabs ElevenLabs $0.125 /1.000 caratteri -
Lyria 3.5 Google $0.090 /brano -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caratteri


