/v2/generateGénérer une API musicale
Musique par défaut Générer un point de terminaison pour la création musicale IA. Prend en charge le mode inspiration et le mode personnalisé.
https://udioapi.pro/api/v2/generatetips
Point de terminaison par défaut : utilisez /v2/generate pour la génération standard.
Modes : le mode Inspiration utilise gpt_description_prompt ; le mode personnalisé utilise prompt, style, title.
Sélection du modèle : choisissez chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 ou chirp-v5-5. Consultez la présentation des modèles et les crédits.
Étape suivante : après avoir appelé ce point de terminaison, utilisez l'API de statut de tâche de génération de musique pour interroger la progression et récupérer les URL audio.
requestHeaders
| name | required | description |
|---|---|---|
nameAuthorization | requiredyes | descriptionJeton du porteur pour l'authentification |
nameContent-Type | requiredyes | descriptionapplication/json |
requestBody
Le corps de la requête prend en charge le mode Inspiration ou le mode personnalisé
Mode inspiration
Générer de la musique à partir d'une description textuelle
| paramName | paramType | required | description | example |
|---|---|---|---|---|
paramNamegpt_description_prompt | paramTypestring | requiredyes | descriptionDescription textuelle de la musique que vous souhaitez générer | exampleA upbeat pop song about summer vacation with catchy melody |
Mode personnalisé
Générez de la musique avec des paroles, un style et un titre personnalisés
| paramName | paramType | required | description | example |
|---|---|---|---|---|
paramNameprompt | paramTypestring | requiredyes | descriptionParoles personnalisées ou invite détaillée | exampleVerse 1: Walking down the street, feeling so free... |
paramNamestyle | paramTypestring | requiredno | descriptionStyle ou genre musical | examplepop, upbeat, electronic, 120 bpm |
paramNametitle | paramTypestring | requiredno | descriptionTitre de la chanson | exampleSummer Dreams |
paramNametags | paramTypestring | requiredno | descriptionBalises négatives à éviter | examplesad, slow |
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
paramNamemodel | paramTypestring | requiredno | descriptionModèle d'IA à utiliser. | examplechirp-v5-5 |
paramNamemake_instrumental | paramTypeboolean | requiredno | descriptionGénérer de la musique instrumentale sans voix | examplefalse |
paramNamegender | paramTypestring | requiredno | descriptionPréférence de genre vocal | examplefemale |
paramNamestyle_weight | paramTypenumber | requiredno | descriptionForce d’adhésion au style | example0.65 |
paramNameweirdness_constraint | paramTypenumber | requiredno | descriptionContrôle les écarts créatifs | example0.65 |
paramNameaudio_weight | paramTypenumber | requiredno | descriptionContrepoids pour les fonctionnalités audio | example0.65 |
responses
{
"code": 200,
"message": "success",
"workId": "gen2abc123def456bksv",
"data": {
"task_id": "gen2abc123def456bksv"
}
}codeExamples
curl -X POST "https://udioapi.pro/api/v2/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "chirp-v4-5",
"prompt": "Verse 1: Walking down the street, feeling so free\nChorus: Summer dreams are calling me",
"style": "pop, upbeat, electronic, 120 bpm",
"title": "Summer Dreams",
"make_instrumental": false,
"gender": "female",
"style_weight": 0.65,
"weirdness_constraint": 0.65,
"audio_weight": 0.65
}'