Si votre produit permet d’importer des chansons, vos utilisateurs peuvent essayer plusieurs arrangements et voix à partir d’un même fichier. Le serveur conserve l’identifiant audio, envoie une tâche par direction, vérifie son état et transmet les versions terminées au lecteur.
Intégration
Champ | Détails |
|---|---|
Point de terminaison |
|
Paramètre du modèle |
|
Source audio | Importez un audio avec purpose=remix pour obtenir upload_audio_id ou utilisez le song_id d’un morceau généré avec Mureka dans le dernier mois. |
Durée | 10–480 s |
Résultats par requête | n vaut 2 par défaut, maximum 3 |
Tarif | Nouvelle version : $0.5 par morceau (V8 reste à $0.2 par morceau). |
Documentation |
Le résultat réinterprète le morceau d’origine, dont le timbre vocal n’est pas conservé. Le choix du timbre d’un artiste précis et l’import d’un fichier audio supplémentaire comme référence de style ne sont pas pris en charge actuellement.
Choix du modèle : dans la requête, définissez model sur mureka-9.5 pour utiliser Remix V9.5, ou sur mureka-8 pour utiliser V8.
Cas d’usage
- Applications de reprises et de remixes : transformez une prise a cappella en versions entièrement arrangées dans plusieurs styles.
- Vidéos courtes et plateformes de contenu : déclinez une même musique de fond en rock, électro ou jazz selon l’ambiance.
- Musiciens et outils de production : développez rapidement une démo jouée, chantée ou fredonnée en un arrangement complet.
- Jeux et publicité : faites varier l’intensité du même thème selon les scènes, comme dans la démo B.
Séquence d’appels à l’API
Préparer l’audio d’origine
Cet exemple utilise un morceau chanté. Appelez POST /v1/files/upload avec purpose défini sur remix et conservez l’identifiant renvoyé. V9.5 accepte les fichiers MP3 et M4A de 10 à 480 secondes. Conservez la clé API côté serveur et utilisez l’authentification Bearer.
curl --fail-with-body https://api.mureka.ai/v1/files/upload \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-F "purpose=remix" \
-F "file=@./original.mp3"
Pour un morceau créé par l’API de génération Mureka, utilisez un song_id éligible. Envoyez upload_audio_id pour un fichier importé ou song_id pour un morceau existant. Choisissez une seule option par requête et consultez leurs limites dans la référence.
Envoyer une tâche pour une direction de remix
Envoyez l’identifiant d’import et un prompt décrivant le style à POST /v1/song/remix. L’exemple précise mureka-9.5 et demande un remix rock avec chant. Remplacez les valeurs d’exemple par l’identifiant renvoyé et les paroles à chanter.
curl --fail-with-body https://api.mureka.ai/v1/song/remix \
-H "Authorization: Bearer ${MUREKA_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"upload_audio_id": "<UPLOAD_AUDIO_ID>",
"model": "mureka-9.5",
"lyrics": "<LYRICS_FOR_THIS_VERSION>",
"prompt": "Keep the chorus melody. Use distorted guitars and live rock drums, with a restrained verse and a bigger chorus.",
"n": 1
}'
Utilisez n pour obtenir plusieurs propositions avec un même prompt. Pour des versions rock, EDM et avec voix féminine, réutilisez l’identifiant d’import dans trois requêtes distinctes. Associez chaque tâche à l’identifiant audio original, au nom de la version et à l’identifiant de tâche.
Suivre la tâche et présenter les résultats
Conservez l’identifiant renvoyé et appelez GET /v1/song/query/{task_id}. Pendant la génération, affichez un état d’attente et continuez à interroger l’API. En cas de succès, utilisez l’URL audio pour l’écoute. En cas d’échec, journalisez l’identifiant et l’erreur.
curl --fail-with-body \
"https://api.mureka.ai/v1/song/query/${TASK_ID}" \
-H "Authorization: Bearer ${MUREKA_API_KEY}"
Dans le lecteur, gardez le même titre pour le morceau original et les remixes, en les distinguant par leur nom de version. Les utilisateurs peuvent retrouver l’original et identifier la version lue.
Documentation de l’API