ElevenLabs
ElevenLabs
elevenlabs/sound-effects-v2
Famiglia di generazione vocale e audio per sviluppatori, che copre sintesi vocale, voce conversazionale, effetti sonori e generazione musicale
Prova elevenlabs/sound-effects-v2
Input
Creazioni
Vedi tutte le creazioniOutput
Prezzi
elevenlabs/sound-effects-v2 per second
| Prezzo unitario | $0.0029 |
|---|
Panoramica
Questo è il modello di generazione di effetti sonori di ElevenLabs, richiamabile tramite l'interfaccia unificata HiAPI.ai: inserendo una descrizione testuale si ottiene direttamente un file audio di effetti sonori. È specializzato nella generazione di suoni ambientali e materiali foley brevi e specifici a partire dalla descrizione, con durata specificabile tra 0,5 e 22 secondi e possibilità di generare versioni in loop senza interruzioni. È adatto a sviluppatori di videogiochi, produttori di video brevi e podcast che necessitano di completare in modo controllato e in batch il livello degli effetti sonori, nonché a team applicativi che integrano la generazione di effetti sonori nelle proprie pipeline di contenuti.
Punti di forza principali
- Durata specificata con precisione dal chiamante——duration_seconds supporta da 0,5 a 22 secondi ed è obbligatorio; non esiste una modalità a durata automatica, quindi la lunghezza dell'output è prevedibile e facilita l'allineamento sulle tracce.
- Aderenza al prompt regolabile in modo quantificabile——prompt_influence assume valori da 0 a 1: valori bassi producono output più liberi e vari, valori alti più fedeli alla descrizione, permettendo di passare tra esplorazione creativa e riproduzione precisa.
- Generazione di effetti sonori in loop senza interruzioni——attivando l'interruttore loop l'output è un suono riproducibile in modo fluido e ciclico, eliminando la necessità di montaggio e dissolvenze in post-produzione.
Descrizione delle capacità
Generazione di effetti sonori da descrizione testuale: descrivendo il suono con un testo non superiore a 450 caratteri, il modello produce l'audio dell'effetto sonoro corrispondente, ideale per trasformare rapidamente una descrizione creativa in materiale sonoro utilizzabile.
Controllo di loop e durata: i parametri loop e duration_seconds controllano la forma dell'output, producendo direttamente audio adatto alla riproduzione in loop nei videogiochi o a segmenti su una timeline fissa.
Regolazione della casualità di generazione: prompt_influence controlla il grado di aderenza alla descrizione; la stessa descrizione può essere riprodotta in modo stabile oppure generata più volte per scegliere varianti diverse.
Scenari di utilizzo
- Sviluppatori di videogiochi che completano suoni ambientali in loop——generare suoni ambientali riproducibili in loop senza interruzioni a partire da una descrizione della scena e dall'interruttore loop, per lo sfondo e l'atmosfera dei livelli.
- Produttori di video brevi e podcast che creano foley——impostando una durata precisa e descrivendo l'immagine si ottengono effetti sonori brevi per transizioni e azioni, da sovrapporre direttamente alla timeline di montaggio.
- Team applicativi che generano risorse sonore in batch——richiamare in batch tramite l'interfaccia in base ai testi, salvando le risorse audio generate nella libreria di materiali o nella pipeline di produzione dei contenuti.
Limiti e consigli per la scelta
Produce solo audio, non genera immagini, video o colonne sonore complete; la durata massima per singola generazione è di 22 secondi, quindi paesaggi sonori lunghi richiedono la giustapposizione di più segmenti; la descrizione è limitata a 450 caratteri e i testi troppo astratti dipendono dal compromesso ottenuto regolando prompt_influence. Per voci, doppiaggio di dialoghi o melodie musicali complete occorre passare a modelli di sintesi vocale o di generazione musicale; anche gli scenari che richiedono lunghi suoni di sottofondo continui non sono adatti all'uso diretto.
Domande frequenti
Vedi tutte le domande →-
Che cos'è Turbo 2.5?
Modello text-to-speech a bassa latenza di ElevenLabs, adatto per assistenti vocali, annunci di notifica e doppiaggio su larga scala.
-
Come si chiama?
Invia model (elevenlabs/text-to-speech-turbo-2-5) e input a POST /v1/tasks, poi usa taskId per interrogare il risultato o configurare callback.
-
Come viene calcolato il costo?
Il costo è calcolato in base al numero di caratteri di input.text, ogni 1.000 caratteri; il prezzo unitario in tempo reale è quello indicato nella sezione prezzi di questa pagina.
-
previous_text e next_text sono a pagamento?
No, sono gratuite. Servono solo a fornire contesto alla sintesi a segmenti, così che l'intonazione risulti naturale e ben collegata.
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-v2
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per elevenlabs/sound-effects-v2 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, ovvero genera un normale effetto sonoro non in loop.
promptstringObbligatoriominLength 1maxLength 450pattern \SDescrive il contenuto dell'effetto sonoro da generare, massimo 450 caratteri.
duration_secondsnumberObbligatorioPredefinito: 2min 0.5max 22Durata dell'effetto sonoro da generare (in secondi), con valori da 0,5 a 22 secondi; questo parametro è obbligatorio, non è disponibile l'opzione di durata automatica, il valore predefinito è 2 secondi.
prompt_influencenumberOpzionalePredefinito: 0.3min 0max 1Controlla quanto il risultato generato aderisce al prompt: 0 indica maggiore variabilità, 1 indica una generazione più strettamente conforme alla descrizione. Tipo numerico, 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-v2",
"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-v2",
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-v2",
"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 →-
Tutoriale
recraft-v4.1-flash text-to-image in pratica: 5 scenari di business ad alto valore e punti chiave di integrazione
Partendo da un costo di $0,01 per immagine, pianificare l'implementazione della generazione di immagini nei processi di business reali
-
Tutoriale
Tutorial su kandinsky-6.0-pro/image-to-video tramite HiAPI: curl + Python
Avvia una richiesta funzionante di image-to-video su HiAPI: dal caricamento del primo fotogramma al polling asincrono fino al download finale
-
Tutoriale
Come usare kling-4.0/text-to-video tramite l'API HiAPI: curl, Python e un esempio di richiesta funzionante
Guida pratica per sviluppatori: prompt cinematografici, audio sincronizzato, polling asincrono e download dell'output
-
Tutoriale
Come chiamare kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
Tutoriale
Come chiamare hailuo-2.3-fast/image-to-video tramite l'API HiAPI: pratica con curl e Python
La prima richiesta funzionante per il livello image-to-video veloce ed economico — dall'ID del modello al download di un MP4
-
Confronto e valutazione
hailuo-2.3-fast/image-to-video confronto orizzontale: come scegliere un modello image-to-video e i punti chiave per la migrazione
-
Confronto e valutazione
Confronto orizzontale di Recraft v4.1 Flash per la generazione di immagini da testo: guida alla scelta e alla migrazione per gli sviluppatori
Con un costo di $0,01 per immagine e la capacità di generazione puramente testuale, valuta se è adatto alla tua pipeline di generazione di immagini
-
Tutoriale
Utilizzare Kandinsky 6.0 Pro su HiAPI per la generazione di video da testo: tutorial con curl e Python
Dimostrazione pratica guidata dalla richiesta: costruire la chiamata da prompt a clip video, inviare la richiesta, monitorare lo stato di completamento e scaricare il risultato
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Gemini 3.1 Flash TTS Google -- -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caratteri -
MiniMax Music 1.5 MiniMax $0.070 /brano -
ElevenLabs ElevenLabs $0.0029 /secondo -
MiniMax Music 3 MiniMax $0.0026 /secondo -
Mirelo SFX 2.0 Mirelo AI $0.021 /secondo -
Mureka 9.5 Mureka $0.322 per request -
Lyria 3.5 Google $0.090 /brano -
Lyria 3 Pro Google $0.140 /brano -
MiniMax Music 2.6 MiniMax $0.210 /brano



