Diffuser la musique composée avec une réponse détaillée

Diffuse en continu un morceau et ses métadonnées détaillées à l’aide des événements envoyés par le serveur, ou SSE.

Paramètres de requête

output_formatenumOptionnelPar défaut auto

Format de sortie de l’audio généré. Formaté sous la forme codec_sample_rate_bitrate. Utilisez “auto”, la valeur par défaut, pour laisser l’API choisir le format le plus adapté au modèle sélectionné : mp3_44100_128 pour les modèles v1 et mp3_48000_192 pour les modèles v2.

Requête

This endpoint expects an object.

promptstring or nullOptionnel<=4100 characters

Un prompt textuel simple à partir duquel générer un morceau. Ne peut pas être utilisé avec composition_plan.

composition_planobject or nullOptionnel

Plan de composition détaillé pour guider la génération de musique. Ne peut pas être utilisé conjointement avec prompt.

music_length_msinteger or nullOptionnel3000-600000

La durée de la chanson à générer, en millisecondes. Utilisée uniquement avec prompt. Elle doit être comprise entre 3 000 ms et 600 000 ms. Facultatif : si elle n’est pas fournie, le modèle choisira une durée en fonction du prompt.

model_idenumOptionnelPar défaut music_v1

Le modèle à utiliser pour la génération.

Valeurs autorisées:

seedinteger or nullOptionnel0-2147483647

Graine aléatoire pour initialiser le processus de génération musicale. Fournir la même graine avec les mêmes paramètres peut aider à obtenir des résultats plus cohérents, mais la reproductibilité exacte n’est pas garantie et les sorties peuvent changer lors des mises à jour du système. Ne peut pas être utilisé avec prompt.

force_instrumentalbooleanOptionnelPar défaut false

Si true, garantit que la chanson générée sera instrumentale. Si false, la chanson peut être instrumentale ou non selon le prompt. Peut uniquement être utilisé avec prompt.

finetune_idstring or nullOptionnel<=100 characters

L’ID du Finetune à utiliser pour la génération

store_for_inpaintingbooleanOptionnelPar défaut false

Indique s’il faut stocker le morceau généré pour l’inpainting.

with_timestampsbooleanOptionnelPar défaut false

Indique s’il faut renvoyer les horodatages des mots du morceau généré.

with_waveform_visualbooleanOptionnelPar défaut false

Indique s’il faut renvoyer la forme d’onde visuelle du morceau généré.

En-têtes de réponse

song-idstringOptionnel

Identifiant unique de la chanson générée

Réponse

Événements envoyés par le serveur pour le plan de composition, les métadonnées de la chanson, les segments audio avec horodatages de mots et forme d’onde visuelle facultatifs, ainsi que la fin de génération.

Erreurs

422

Unprocessable Entity Error