Come si usa l'API Mureka 9.5? La tua prima canzone in 5 minuti

TL;DR

• Cos'è: Mureka 9.5 è un modello di generazione musicale e su HiAPI ha due percorsi: da testo a canzone, in cui invii il testo completo e ricevi un brano finito con voce principale, cori e accompagnamento; e solo strumentale, in cui invii solo una descrizione e ricevi un brano strumentale senza voce. Mureka 9.5 è già disponibile su HiAPI: apri la pagina del modello da testo a canzone per ascoltare e generare online; i nuovi utenti ricevono 200 crediti alla registrazione.
• Quanto costa: ogni generazione riuscita costa $0.3215 (643 crediti), lo stesso prezzo per entrambi i percorsi, indipendentemente dalla lunghezza del testo e dalla durata dell'output; in caso di fallimento l'importo prenotato viene rimborsato. Con $10 si ottengono circa 31 brani.
• Come provarlo subito: nella pagina del modello incolla il testo, scegli la voce principale e premi Esegui; per integrarlo nel tuo prodotto usa POST /v1/tasks, imposta model a mureka-9.5/lyrics-to-song e con il taskId fai polling per ottenere l'URL.

Cos'è Mureka 9.5?

Il testo è già definitivo, manca solo una canzone cantata finita: il percorso da testo a canzone di Mureka 9.5 riduce tutto questo a una singola richiesta. Inserisci il testo completo in lyrics, usa il prompt opzionale per aggiungere genere, atmosfera, strumenti, ritmo e caratteristiche vocali, e con gender fissi se la voce principale è femminile o maschile: in un'unica risposta ricevi una canzone mixata, in output MP3, stereo a 44,1 kHz, circa 256 kbps.

I tre esempi reali presenti nel sito durano rispettivamente 1:49, 3:02 e 3:30, provengono tutti dallo stesso percorso e hanno lo stesso prezzo unitario. Non offre la scrittura automatica del testo e non accetta brani di riferimento o melodie: il confine dell'input è il testo più una direzione di genere.

Ascolta prima due brani reali

City Night Drive del percorso da testo a canzone e Wide-screen Overture del percorso solo strumentale sono entrambi una singola richiesta da $0.3215.

Ascolta: City Night Drive, indie pop inglese, 1:49

Da testo a canzone: City Night Drive · 1:49 · MP3 44,1 kHz stereo 256 kbps

Ascolta: Wide-screen Overture, orchestrale cinematografico, 3:12

Solo strumentale: Wide-screen Overture · 3:12 · MP3 44,1 kHz stereo 256 kbps

Qual è la differenza tra i due percorsi

	Da testo a canzone	Solo strumentale
ID del modello	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Campi obbligatori	lyrics (1–5.000 caratteri)	prompt (1–1.024 caratteri)
Campi opzionali	prompt (1–2.000 caratteri), gender (female / male)	nessuno
Output	Canzone completa con voce	Strumentale senza voce
Durata	Decisa dal modello in base alla struttura del testo	Decisa dal modello, non c'è un parametro di durata
Prezzo unitario	$0.3215 / richiesta	$0.3215 / richiesta

Se vuoi una canzone cantata scegli il percorso di sinistra, se vuoi una colonna sonora scegli quello di destra. In entrambi i casi non puoi inserire la durata; i tre esempi strumentali nel sito durano 3:12, 3:08 e 3:03.

Prova online: 4 passaggi

1. Apri la pagina del modello da testo a canzone: nella pagina puoi ascoltare direttamente i tre esempi presenti nel sito.
2. Nel campo del testo incolla il testo completo riga per riga, usando marcatori di sezione come [Verse 1] e [Chorus] per suddividerlo.
3. Nel campo della direzione di stile scrivi genere, atmosfera, strumenti e caratteristiche vocali; per il sesso della voce principale scegli femminile o maschile.
4. Premi «Esegui» e, al termine dell'attività, potrai riprodurre e scaricare il brano. Ogni volta $0.3215.

Per il solo strumentale sostituisci il passaggio 2 con una descrizione strumentale; apri la pagina del modello solo strumentale e segui gli stessi quattro passaggi.

Per la prima prova puoi usare direttamente questa direzione di stile:

Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.

Genera con questo prompt →

Dopo averlo aperto verrà inserito nel campo della direzione di stile; poi incolla quattro tue frasi di testo, scegli la voce femminile e potrai realizzare la tua prima canzone.

Integrazione API: 4 passaggi

1. Dopo la registrazione, crea una API Key nella console.
2. Invia model e input con POST https://api.hiapi.ai/v1/tasks.
3. Prendi l'ID dell'attività da data.taskId nella risposta e fai polling su GET /v1/tasks/{taskId} oppure attendi il callback.
4. Quando lo stato diventa success, prendi da data.output la voce con type=audio e scarica l'MP3.

Da testo a canzone: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
      "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
      "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
      "gender": "female"
    }
  }'

Dalla risposta prendi l'ID dell'attività:

{"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

Solo strumentale: curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mureka-9.5/instrumental",
    "input": {
      "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb."
    }
  }'

Controlla lo stato:

curl -s https://api.hiapi.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

data.status può essere in sequenza queued, handling, success o fail.

Python: creare l'attività, fare polling, ottenere il link

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/lyrics-to-song",
    "input": {
        "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold",
        "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
        "gender": "female",
    },
}

resp = requests.post(BASE, headers=HEADERS, json=payload, timeout=30)
task_id = resp.json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

if data["status"] == "success":
    audio_url = next(item["url"] for item in data["output"] if item["type"] == "audio")
    print(audio_url)
else:
    print(data.get("error"))

Per il solo strumentale si usa la stessa logica di polling, cambiando solo il contenuto inviato; funziona anche da solo:

import time
import requests

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

payload = {
    "model": "mureka-9.5/instrumental",
    "input": {
        "prompt": "Cinematic orchestral instrumental with a fragile piano ostinato, evolving string swells, low brass and soft timpani, hopeful then resolute, wide film-score reverb.",
    },
}

task_id = requests.post(BASE, headers=HEADERS, json=payload, timeout=30).json()["data"]["taskId"]

while True:
    data = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
    if data["status"] in ("success", "fail"):
        break
    time.sleep(10)

print(next((item["url"] for item in data.get("output", []) if item["type"] == "audio"), data.get("error")))

Output e formato

Ogni richiesta restituisce un MP3, 44,1 kHz, stereo, circa 256 kbps. Per il download cerca in data.output la voce con type uguale a audio; non cercare una stringa al livello superiore della risposta.

L'url restituito scade: prima di salvarlo nel database, trasferisci il file nel tuo storage.

Da tenere presente prima della messa in produzione

1. Aggiungi il polling come rete di sicurezza per il callback. Nel corpo della richiesta puoi includere "callback": {"url": "https://yourapp.com/webhook", "when": "final"}; la notifica arriva quando l'attività raggiunge lo stato finale. La notifica può andare persa, quindi affiancala a una query periodica.
2. Salva prima il taskId, non inviare di nuovo la POST. Ogni creazione di attività viene addebitata; quando il client va in timeout l'attività potrebbe essere già stata creata. Salva taskId nel database e controlla lo stato prima di riprovare.
3. Suddividi il testo riga per riga. Una frase per riga, mantenendo l'ordine di strofe e ritornelli, con marcatori di sezione chiari: la struttura risulta molto più stabile. Limite massimo 5.000 caratteri.
4. Indica esplicitamente il sesso della voce principale. Se non lo passi, lo decide il modello; per serie di canzoni o brani di brand, fissa female o male così la voce resta coerente con lo stesso materiale.

FAQ

Posso lasciare vuoto il testo e far scrivere tutto al modello? No. lyrics è obbligatorio, da 1 a 5.000 caratteri. Per la scrittura automatica del testo usa un modello musicale che supporta i testi automatici.

Quanto può durare al massimo una canzone? Non c'è un parametro di durata: la lunghezza è decisa dal modello in base alla struttura del testo. I tre esempi da testo a canzone nel sito durano 1:49, 3:02 e 3:30, mentre i tre strumentali durano 3:12, 3:08 e 3:03.

Il solo strumentale può generare voci? No. Il percorso solo strumentale non genera voci cantate, anche se nella descrizione scrivi una voce principale; se vuoi la voce, passa al percorso da testo a canzone.

Se la generazione fallisce vengono addebitati costi? No. L'importo prenotato per le attività fallite viene rimborsato automaticamente.

Ora realizza la tua prima canzone

Incolla il curl qui sopra nel terminale, sostituisci YOUR_API_KEY con la tua key e il testo con il tuo: otterrai il primo taskId. Se vuoi prima vedere il risultato, apri la pagina del modello da testo a canzone e premi Esegui. La documentazione completa è nelle pagine integrazione da testo a canzone e integrazione solo strumentale.

Letture correlate: Prezzi Mureka 9.5: $0.3215 a brano · Mureka 9.5 vs MiniMax Music 2.6 · Guida completa ai prompt di Mureka 9.5: 6 casi reali