Mirelo AI
Mirelo SFX 2.0
mirelo-sfx-2.0
Modello di output audio pensato per scenari di generazione di effetti sonori, adatto alla produzione e all'iterazione in batch di materiali sonori per video, giochi e altri contenuti
Prova mirelo-sfx-2.0
Input
Creazioni
Vedi tutte le creazioniOutput
Prezzi
mirelo-sfx-2.0 per second
| Prezzo unitario | $0.0215 |
|---|
Panoramica e posizionamento
mirelo-sfx-2.0 è un modello di generazione di effetti sonori accessibile tramite l'interfaccia unificata di HiAPI.ai: riceve un prompt testuale e restituisce un file audio. Chi lo utilizza descrive nel prompt la sorgente sonora, il materiale, l'azione, la distanza e l'ambiente, specificando una durata compresa tra 1 e 30 secondi (5 secondi per impostazione predefinita). È adatto agli sviluppatori di video, giochi e contenuti interattivi che necessitano di produrre effetti sonori in grandi quantità, nonché ai team che desiderano integrare la generazione di effetti sonori nei propri flussi di produzione automatizzati.
Punti di forza principali
- Generazione di effetti sonori direttamente da una descrizione testuale: basta descrivere nel prompt sorgente sonora, materiale, azione, distanza e ambiente per ottenere l'audio corrispondente, senza bisogno di registrare o campionare materiali.
- Durata di generazione specificabile in secondi: ogni generazione supporta da 1 a 30 secondi, con 5 secondi predefiniti, così da adattare l'effetto sonoro alla durata effettiva di un'inquadratura o di un evento interattivo.
- Tariffazione unificata in base ai secondi di output: il costo è direttamente proporzionale alla durata dell'audio generato, rendendo prevedibili i costi sia degli effetti brevi sia di quelli lunghi.
Descrizione delle capacità
Generazione di effetti sonori guidata da prompt: descrivendo il suono desiderato con un testo fino a 2000 caratteri, il modello restituisce l'audio corrispondente, eliminando la ricerca e la registrazione di materiali.
Durata audio controllabile: tramite il parametro duration si specifica una lunghezza di output da 1 a 30 secondi, utile per allinearsi al ritmo di clip video, inquadrature animate o feedback interattivi.
Descrizione sonora strutturata: il prompt consente di descrivere combinazioni di sorgente sonora, materiale, azione, distanza e ambiente, facilitando la caratterizzazione della spazialità e della texture degli effetti sonori in base a scenari specifici.
Integrazione tramite interfaccia unificata: grazie a un'unica interfaccia di HiAPI.ai, l'audio prodotto può essere inserito direttamente nelle pipeline audio o di contenuti esistenti.
Casi d'uso
- Montatori video che aggiungono suoni d'ambiente alle inquadrature: inserendo la descrizione sonora corrispondente al contenuto dell'inquadratura e impostando la durata, si ottiene un effetto d'ambiente da collocare direttamente sulla timeline.
- Sviluppatori di giochi che creano effetti sonori interattivi: descrivendo azione e materiale si generano effetti brevi, da riprodurre al verificarsi di eventi come feedback di pulsanti, collisioni o raccolta di oggetti.
- Team di contenuti che iterano in blocco le soluzioni sonore: modificando più volte i termini descrittivi dello stesso prompt si generano più varianti, da confrontare rapidamente per scegliere quella definitiva da usare nel prodotto finale.
Limitazioni e consigli per la scelta
Attualmente è supportato solo l'input testuale: non è possibile caricare audio di riferimento per il trasferimento timbrico o l'abbinamento stilistico; la durata massima dell'output è di 30 secondi, quindi suoni continui più lunghi richiedono la generazione a segmenti e un successivo montaggio manuale. Se l'attività richiede voce, musica o brani con testo, occorre scegliere i modelli corrispondenti di sintesi vocale o generazione musicale. Nei casi che impongono requisiti rigorosi su dettagli quali spettro e dinamica degli effetti sonori, si consiglia di generare prima materiali candidati e poi procedere a selezione manuale e post-produzione.
Novità
Vedi il changelog →- Nuovo modello Nuovo modello: mirelo-sfx-2.0 (Mirelo SFX 2.0 text-to-sound-effect, POST /v1/tasks). Descrivi la...
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: mirelo-sfx-2.0
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per mirelo-sfx-2.0 e la route default — vedi la tabella dei parametri sotto.
promptstringObbligatoriominLength 1maxLength 2000pattern \SServe a descrivere l'effetto sonoro da generare; si consiglia di includere elementi come la sorgente sonora, il materiale, l'azione, la distanza e l'ambiente; stringa, massimo 2.000 caratteri.
durationintegerOpzionalePredefinito: 5min 1max 30Controlla la durata dell'effetto sonoro generato, in secondi, con un valore intero compreso tra 1 e 30; predefinito 5 secondi.
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": "mirelo-sfx-2.0",
"input": {
"prompt": "…",
"duration": 5
}
}' 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: "mirelo-sfx-2.0",
input: {
"prompt": "…",
"duration": 5
}
}),
});
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": "mirelo-sfx-2.0",
"input": {
"prompt": "…",
"duration": 5
}
},
)
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 →-
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
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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 kling-4.0/image-to-video su HiAPI: curl, Python e polling
-
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
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 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
-
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
-
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
Modelli correlati
Vedi tutti i modelli →Stesso tipo
-
Mureka 9.5 Mureka $0.322 per request -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caratteri -
ElevenLabs ElevenLabs $0.0029 /secondo -
MiniMax Music 1.5 MiniMax $0.070 /brano -
Gemini 3.1 Flash TTS Google -- -
MiniMax Music 2.6 MiniMax $0.210 /brano -
Lyria 3 Pro Google $0.140 /brano -
MiniMax Music 3 MiniMax $0.0026 /secondo -
Lyria 3.5 Google $0.090 /brano



