Génération de musique et de reprises

Générez de la musique ou une reprise de manière synchrone avec le protocole musical MiniMax.

Cette interface génère de la musique ou une reprise dans une même requête HTTP synchrone. Une requête standard peut renvoyer une URL audio temporaire ou du contenu audio Hex ; une requête en streaming renvoie des fragments audio JSON ligne par ligne.

Pour un résultat en streaming, concaténez le contenu Hex de data.audio dans l’ordre de réception, puis terminez le décodage et l’enregistrement après réception de data.status=2. Même avec un statut HTTP 200, vérifiez base_resp.status_code : seule la valeur 0 indique un succès métier.

POST/v1/music_generation

Génère de la musique ou une reprise de manière synchrone. Avec stream=true, la réponse renvoie des fragments audio JSON ligne par ligne sur la même connexion HTTP, sans créer de tâche asynchrone.

Dans une réponse en streaming, data.audio contient un fragment audio Hex à concaténer dans l’ordre de réception ; data.status=2 indique que la génération est terminée.

Les réponses en streaming renvoient toujours des fragments audio Hex. Avec stream=true, même si vous indiquez output_format=url, la passerelle actuelle peut ignorer cette valeur et renvoyer un flux Hex.

Authentification

bearerAuth

AuthentificationBearer <token>

Utilisez Bearer your-api-key dans le Header Authorization.

Emplacement: header

Corps de requête

application/json

Paramètres de génération de musique ou de reprises. Les conditions rendant les champs obligatoires dépendent du mode de génération.

Définitions TypeScript

Utilisez le type request body en TypeScript.

model*string

ID d’un modèle musical MiniMax visible pour la clé API actuelle, par exemple music-3.0, music-2.6 ou music-cover.

prompt?string

Description du style, de l’émotion et de la scène. Obligatoire en mode instrumental ; peut être omise dans les autres modes.

Longueurlength <= 2000

lyrics?string

Paroles séparées par des sauts de ligne. Généralement obligatoires pour une chanson avec voix ; si l’optimisation des paroles est activée et que ce champ est vide, elles peuvent être générées automatiquement.

Longueurlength <= 3500

stream?boolean

Indique si la réponse HTTP actuelle renvoie ligne par ligne des fragments audio Hex au format JSON.

Valeur par défautfalse

output_format?string

Mode de retour de l’audio. Les réponses en streaming utilisent toujours hex ; même avec url, la passerelle actuelle peut ignorer cette valeur et renvoyer des fragments Hex. Les URL expirent généralement après 24 heures.

Valeur par défaut"hex"

Valeurs autorisées

"url"
"hex"

audio_setting?

lyrics_optimizer?boolean

Indique si les paroles sont générées automatiquement à partir du prompt lorsque le champ des paroles est vide.

Valeur par défautfalse

is_instrumental?boolean

Indique si vous souhaitez générer une musique instrumentale sans voix. Avec true, lyrics n’est pas obligatoire.

Valeur par défautfalse

audio_url?string

URL de l’audio de référence pour la reprise ; ne peut pas être utilisée avec audio_base64 ou cover_feature_id.

Formaturi

audio_base64?string

Audio de référence de la reprise en Base64 ; ne peut pas être utilisé avec audio_url ou cover_feature_id.

cover_feature_id?string

ID des caractéristiques renvoyé par le prétraitement de la reprise, valable pendant 24 heures. Son utilisation exige des paroles de 10 à 1000 caractères.

aigc_watermark?boolean

Indique si un filigrane AIGC doit être ajouté à la fin de l’audio ; ne s’applique qu’aux requêtes sans streaming.

Valeur par défautfalse

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/music_generation" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "Piano et cordes délicats, lever du soleil, ambiance chaleureuse et apaisante, style bande originale de film",    "is_instrumental": true,    "audio_setting": {      "sample_rate": 44100,      "bitrate": 256000,      "format": "mp3"    },    "output_format": "url",    "stream": false  }'

{
  "data": {
    "audio": "https://example.com/music/output.mp3",
    "status": 2
  },
  "trace_id": "04ede0ab069fb1ba8be5156a24b1e081",
  "extra_info": {
    "music_duration": 244262,
    "music_sample_rate": 44100,
    "music_channel": 2,
    "bitrate": 256000,
    "music_size": 7818388
  },
  "analysis_info": null,
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Génération de musique et de reprises

Authentification

Corps de requête

Corps de réponse

200application/json

401application/json

`application/json`

`application/json`