/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 |
|---|---|---|
Authorization | yes | Jeton du porteur pour l'authentification |
Content-Type | yes | application/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 |
|---|---|---|---|---|
gpt_description_prompt | string | yes | Description textuelle de la musique que vous souhaitez générer | A 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 |
|---|---|---|---|---|
prompt | string | yes | Paroles personnalisées ou invite détaillée | Verse 1: Walking down the street, feeling so free... |
style | string | no | Style ou genre musical | pop, upbeat, electronic, 120 bpm |
title | string | no | Titre de la chanson | Summer Dreams |
tags | string | no | Balises négatives à éviter | sad, slow |
commonParams
| paramName | paramType | required | description | example |
|---|---|---|---|---|
model | string | no | Modèle d'IA à utiliser. | chirp-v5-5 |
make_instrumental | boolean | no | Générer de la musique instrumentale sans voix | false |
gender | string | no | Préférence de genre vocal | female |
style_weight | number | no | Force d’adhésion au style | 0.65 |
weirdness_constraint | number | no | Contrôle les écarts créatifs | 0.65 |
audio_weight | number | no | Contrepoids pour les fonctionnalités audio | 0.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
}'