Comment utiliser l'API Mureka 9.5 ? Générez votre première chanson en 5 minutes

TL;DR

• Qu'est-ce que c'est : Mureka 9.5 est un modèle de génération musicale, disponible sur HiAPI via deux routes — paroles vers chanson soumet des paroles complètes et renvoie une chanson finie avec chant principal, harmonies et accompagnement ; instrumental soumet uniquement une description et renvoie un instrumental sans voix. Mureka 9.5 est déjà en ligne sur HiAPI, ouvrez la page du modèle paroles vers chanson pour écouter et générer en ligne ; les nouveaux utilisateurs reçoivent 200 crédits à l'inscription.
• Combien ça coûte : chaque génération réussie coûte 0,3215 $ (643 crédits), les deux routes au même prix, indépendamment de la longueur des paroles et de la durée de sortie ; en cas d'échec, la pré-autorisation est remboursée. 10 $ permettent environ 31 chansons.
• Comment démarrer au plus vite : collez vos paroles sur la page du modèle, choisissez la voix principale et cliquez sur exécuter ; pour intégrer à votre produit, utilisez POST /v1/tasks avec model défini sur mureka-9.5/lyrics-to-song, récupérez le taskId et interrogez pour obtenir l'URL.

Qu'est-ce que Mureka 9.5 ?

Les paroles sont finalisées, il ne manque que la chanson interprétée : la route paroles vers chanson de Mureka 9.5 réduit cela à une seule requête. Vous placez les paroles complètes dans lyrics, utilisez le prompt optionnel pour préciser le style, l'émotion, les instruments, le rythme et les caractéristiques vocales, et gender pour fixer si la voix principale est féminine ou masculine ; une seule requête renvoie une chanson mixée, en sortie MP3, 44,1 kHz stéréo, environ 256 kbps.

Les trois exemples réels sur le site durent respectivement 1:49, 3:02 et 3:30, tous issus de la même route et au même prix unitaire. Il ne propose pas d'écriture automatique des paroles et n'accepte ni morceau de référence ni mélodie ; les entrées se limitent aux paroles plus une direction de style.

Écoutez d'abord deux morceaux réels

City Night Drive de la route paroles vers chanson et Wide-screen Overture de la route instrumentale sont tous deux issus d'une seule requête à 0,3215 $.

Écouter : City Night Drive, indie pop anglais, 1:49

Paroles vers chanson : City Night Drive · 1:49 · MP3 44,1 kHz stéréo 256 kbps

Écouter : Wide-screen Overture, orchestral cinématographique, 3:12

Instrumental : Wide-screen Overture · 3:12 · MP3 44,1 kHz stéréo 256 kbps

Quelle différence entre les deux routes

	Paroles vers chanson	Instrumental
ID du modèle	mureka-9.5/lyrics-to-song	mureka-9.5/instrumental
Champs obligatoires	lyrics (1–5 000 caractères)	prompt (1–1 024 caractères)
Champs optionnels	prompt (1–2 000 caractères), gender (female / male)	aucun
Sortie	Chanson complète avec voix	Instrumental sans voix
Durée	Déterminée par le modèle selon la structure des paroles	Déterminée par le modèle, aucun paramètre de durée
Prix unitaire	0,3215 $ / requête	0,3215 $ / requête

Pour une chanson avec voix, prenez la route de gauche ; pour une musique de fond, celle de droite. Aucune des deux ne permet de saisir la durée ; les trois exemples instrumentaux sur le site durent 3:12, 3:08 et 3:03.

Essai en ligne : 4 étapes

1. Ouvrez la page du modèle paroles vers chanson ; vous pouvez y écouter directement les trois exemples du site.
2. Dans le champ des paroles, collez ligne par ligne les paroles complètes, en segmentant avec des marqueurs de section comme [Verse 1], [Chorus].
3. Dans le champ de direction de style, indiquez le genre, l'émotion, les instruments et les caractéristiques vocales ; choisissez le sexe de la voix principale, féminine ou masculine.
4. Cliquez sur « Exécuter » et attendez la fin de la tâche pour lire et télécharger. Chaque fois 0,3215 $.

Pour l'instrumental, remplacez l'étape 2 par une description instrumentale ; ouvrez la page du modèle instrumental, également en quatre étapes.

Pour un premier essai, vous pouvez utiliser directement cette direction de style :

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.

Générer avec ce prompt →

Une fois ouvert, il sera inséré dans le champ de direction de style ; collez ensuite quatre lignes de vos propres paroles, choisissez une voix féminine et vous pourrez générer votre première chanson.

Intégration API : 4 étapes

1. Après inscription, créez une clé API dans la console.
2. POST https://api.hiapi.ai/v1/tasks avec model et input.
3. Récupérez l'ID de tâche depuis data.taskId de la réponse, puis interrogez GET /v1/tasks/{taskId} ou attendez le callback.
4. Une fois le statut passé à success, récupérez dans data.output l'entrée type=audio et téléchargez le MP3.

Paroles vers chanson : 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"
    }
  }'

Récupérez l'ID de tâche dans la réponse :

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

Instrumental : 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."
    }
  }'

Vérifier le statut :

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

data.status peut prendre successivement les valeurs queued, handling, success ou fail.

Python : créer la tâche, interroger, récupérer le lien

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"))

Pour l'instrumental, utilisez la même logique d'interrogation en changeant seulement le contenu soumis ; il peut aussi fonctionner seul :

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")))

Sortie et format

Chaque requête renvoie un MP3, 44,1 kHz, stéréo, environ 256 kbps. Lors du téléchargement, cherchez dans data.output l'élément dont type vaut audio ; ne cherchez pas une chaîne au niveau supérieur de la réponse.

L'url renvoyée expire ; avant de la stocker, transférez d'abord le fichier vers votre propre stockage.

À vérifier avant la mise en production

1. Ajoutez un filet de sécurité par interrogation en plus du callback. Le corps de la requête peut inclure "callback": {"url": "https://yourapp.com/webhook", "when": "final"} ; une notification est envoyée lorsque la tâche atteint un état terminal. La notification peut se perdre, ajoutez donc une vérification périodique en complément.
2. Stockez d'abord le taskId, ne repostez pas. Chaque création de tâche est facturée ; en cas de timeout côté client, la tâche peut déjà avoir été créée. Enregistrez le taskId en base et vérifiez le statut avant de réessayer.
3. Segmentez les paroles ligne par ligne. Une ligne par phrase, en conservant l'ordre des couplets et refrains et en écrivant clairement les marqueurs de section, la structure sera bien plus stable ; limite de 5 000 caractères.
4. Indiquez explicitement le sexe de la voix principale. Sans indication, c'est le modèle qui décide ; pour une série de chansons ou une chanson de marque, fixez female ou male pour que la voix reste cohérente avec le même matériel.

FAQ

Peut-on laisser les paroles vides et laisser le modèle les écrire automatiquement ? Non. lyrics est obligatoire, 1–5 000 caractères. Pour l'écriture automatique des paroles, utilisez un modèle musical qui prend en charge les paroles automatiques.

Quelle est la durée maximale d'une chanson ? Il n'y a pas de paramètre de durée ; la longueur est déterminée par le modèle selon la structure des paroles. Les trois exemples paroles vers chanson sur le site durent 1:49, 3:02 et 3:30 ; les trois instrumentaux durent 3:12, 3:08 et 3:03.

L'instrumental peut-il produire de la voix ? Non. La route instrumentale ne génère pas de voix chantée, même si la description mentionne un chanteur principal ; pour de la voix, passez à la route paroles vers chanson.

Une génération échouée est-elle facturée ? Non. Le montant pré-autorisé des tâches échouées est automatiquement remboursé.

Générez votre première chanson maintenant

Collez le curl ci-dessus dans votre terminal, remplacez YOUR_API_KEY par votre clé et les paroles par les vôtres, et vous obtiendrez votre premier taskId. Pour voir d'abord le résultat, ouvrez directement la page du modèle paroles vers chanson et cliquez sur exécuter. Documentation complète : documentation d'intégration paroles vers chanson et documentation d'intégration instrumental.

À lire aussi : Tarifs Mureka 9.5 : 0,3215 $ par chanson · Mureka 9.5 vs MiniMax Music 2.6 · Guide complet des prompts Mureka 9.5 : 6 cas réels