Lyria 3.5
lyria-3.5
Modello di punta di Google per la generazione musicale: pianifica prima intro, strofe, ritornelli e altre strutture, poi genera brani completi con voce e testo, supporta il canto in più lingue ed è richiamabile tramite l'interfaccia unificata di HiAPI.ai
Prova lyria-3.5
Input
Creazioni
Vedi tutte le creazioniOutput
audioPrezzi
lyria-3.5 per song
| Prezzo unitario | $0.090 |
|---|
Panoramica
Lyria 3.5 è un modello pensato per la generazione di musica da testo, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Può generare un brano completo a partire da una descrizione musicale (genere, strumenti, atmosfera, struttura), oppure interpretare un testo cantato fornito direttamente con marcatori di sezione come [Verse] e [Chorus], con la possibilità di specificare durata, BPM, titolo e seed casuale. L'output è una canzone completa con voce, adatta a sviluppatori che necessitano di ottenere rapidamente un prodotto finito ben strutturato, per colonne sonore di contenuti, brani multilingua e validazione di demo creative.
Punti di forza principali
- Organizza l'intera canzone per sezioni, non per frammenti giustapposti — prima della generazione pianifica intro, strofe, ritornello, bridge e altre strutture, producendo un risultato con sezioni ben distinte e coerenti.
- Basta una descrizione o un testo per ottenere un brano — con la sola descrizione musicale si ottiene un'opera strumentale o con voce, con il solo testo si passa direttamente alla generazione del canto.
- Durata e velocità vincolabili nella richiesta — è possibile specificare una durata target da 1 a 240 secondi e un BPM numerico, per riservare la lunghezza in base al canale di distribuzione.
Descrizione delle capacità
Generazione di un brano completo da descrizione testuale: con una descrizione fino a 10000 caratteri che indichi genere, strumenti, atmosfera e struttura si ottiene direttamente un brano completo, riducendo le fasi di arrangiamento e montaggio manuali.
Canto guidato dal testo: inviando un testo con marcatori di sezione si genera una canzone con voce, con la possibilità di inserire un titolo, ottenendo una demo di testo e musica ascoltabile direttamente.
Durata e velocità controllabili: è possibile richiedere una durata target da 1 a 240 secondi e specificare il BPM; la durata effettiva dell'output può discostarsi dal valore richiesto, quindi occorre progettare per un intervallo anziché per un valore esatto.
Seed casuale e tentativi riproducibili: è possibile passare un seed numerico per organizzare più cicli di generazione, ma le stesse impostazioni non garantiscono un audio identico, rendendolo adatto all'esplorazione di varianti piuttosto che alla riproduzione deterministica.
Output solo audio: restituisce un file audio finito, inseribile direttamente nella libreria di materiali o nei successivi flussi di distribuzione, senza necessità di conversione di formato.
Scenari applicativi
- Colonne sonore per video brevi e podcast di creatori di contenuti — inserendo una descrizione musicale di atmosfera e ritmo si ottiene una musica di sottofondo corrispondente alla durata del prodotto finale, da collocare direttamente nella timeline di montaggio.
- Demo di ascolto di testi per musicisti — inviando un testo con marcatori [Verse] e [Chorus] si produce una versione cantata ascoltabile, utile per la validazione creativa di testo e musica e il confronto tra versioni.
- Colonne sonore personalizzate per pubblicità e contenuti di brand — generando brani originali aderenti al tono visivo tramite descrizioni di genere, strumenti e atmosfera, come base musicale per i materiali di distribuzione.
- Prototipi di colonne sonore per videogiochi e media interattivi — generazione in batch di frammenti atmosferici con descrizione, BPM e vincoli di durata, come prototipi iniziali di musica per livelli o interfacce da sottoporre al team per la revisione.
Limiti e suggerimenti di scelta
Supporta solo input testuali e testi cantati, non accetta guide visive; l'output è un file audio con watermark e i risultati della generazione non sono memorizzabili in cache. La durata di un singolo brano va da pochi secondi ad alcuni minuti, quindi non è adatto a colonne sonore continue di lunga durata né a consegne lossless ad alta fedeltà. La durata effettiva dell'output e i dettagli audio non sono garantiti pienamente conformi ai parametri richiesti, e lo stesso seed non riproduce lo stesso risultato. Per editing audio preciso e controllabile, tracce separate o riproduzione deterministica occorre valutare altre soluzioni; questo modello è più adatto alla produzione rapida di brani completi e ben strutturati.
Novità
Vedi il changelog →- Nuovo modello Aggiunta della documentazione API di lyria-3.5
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: lyria-3.5
routestringOpzionaleValore fisso attuale: default
inputobjectObbligatorio
Oggetto di parametri di business per lyria-3.5 e la route default — vedi la tabella dei parametri sotto.
bpmstringOpzionalepattern ^[1-9][0-9]*(\.[0-9]+)?$Opzionale, specifica il tempo (BPM) del brano generato, passato come stringa numerica, con un valore minimo di 1.
seedstringOpzionaleminLength 1pattern ^[0-9]+$Opzionale, seed casuale, passato come stringa numerica; impostazioni identiche non garantiscono la generazione di un audio esattamente uguale.
titlestringOpzionaleOpzionale, specifica il titolo del brano generato.
lengthintegerOpzionalemin 1max 240Opzionale, durata richiesta dell'audio (in secondi), con valori da 1 a 240; la durata effettiva dell'output potrebbe differire.
lyricsstringOpzionaleminLength 1pattern \SOpzionale, contenuto del testo della canzone, è possibile usare tag di sezione come [Verse], [Chorus]; è necessario fornire almeno uno tra testo e descrizione musicale.
promptstringOpzionaleminLength 1maxLength 10000pattern \SOpzionale, descrizione musicale, usata per indicare stile, strumenti, atmosfera e struttura; è necessario fornire almeno uno tra descrizione musicale e testo.
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": "lyria-3.5",
"input": {}
}' 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: "lyria-3.5",
input: {}
}),
});
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": "lyria-3.5",
"input": {}
},
)
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
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
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
-
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
-
Tutoriale
Come chiamare hailuo-2.3/text-to-video tramite l'API HiAPI: curl, Python ed esempi di richiesta eseguibili
-
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 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 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
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 -
MiniMax Music 3 MiniMax $0.0026 /secondo -
MiniMax Music 2.6 MiniMax $0.210 /brano -
Mirelo SFX 2.0 Mirelo AI $0.021 /secondo -
ElevenLabs ElevenLabs $0.0029 /secondo -
Lyria 3 Pro Google $0.140 /brano -
MiniMax Music 1.5 MiniMax $0.070 /brano -
Gemini 3.1 Flash TTS Google --
Stesso fornitore
-
Nano Banana Google $0.021 /immagine -
Nano Banana Pro Google $0.057 /immagine -
Veo 3.1 Google $0.290 /secondo -
Nano Banana 2 Google $0.036 /immagine -
Nano Banana 2 Lite Google $0.033 /immagine -
Google Virtual Try-On Google $0.107 /immagine -
Imagen 4 Google $0.030 /immagine -
Gemini Omni Google -- -
Veo 3.1 Lite Google $0.060 /secondo -
Lyria 3 Pro Google $0.140 /brano -
Gemini 3.1 Flash TTS Google -- -
Gemini Omni 1.1 Flash Google $0.450 /video



