Points d'accès API

Générer de la musique

POST/v2/generate

Gé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é.

POSThttps://udioapi.pro/api/v2/generate

tips

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

namerequireddescription
AuthorizationyesJeton du porteur pour l'authentification
Content-Typeyesapplication/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

paramNameparamTyperequireddescriptionexample
gpt_description_promptstringyesDescription textuelle de la musique que vous souhaitez générerA 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

paramNameparamTyperequireddescriptionexample
promptstringyesParoles personnalisées ou invite détailléeVerse 1: Walking down the street, feeling so free...
stylestringnoStyle ou genre musicalpop, upbeat, electronic, 120 bpm
titlestringnoTitre de la chansonSummer Dreams
tagsstringnoBalises négatives à évitersad, slow

commonParams

paramNameparamTyperequireddescriptionexample
modelstringnoModèle d'IA à utiliser.chirp-v5-5
make_instrumentalbooleannoGénérer de la musique instrumentale sans voixfalse
genderstringnoPréférence de genre vocalfemale
style_weightnumbernoForce d’adhésion au style0.65
weirdness_constraintnumbernoContrôle les écarts créatifs0.65
audio_weightnumbernoContrepoids pour les fonctionnalités audio0.65

responses

json
{
  "code": 200,
  "message": "success",
  "workId": "gen2abc123def456bksv",
  "data": {
    "task_id": "gen2abc123def456bksv"
  }
}
json
{
  "code": 400,
  "message": "No body provided"
}
json
{
  "code": 401,
  "message": "No API key provided in Authorization header"
}
json
{
  "code": 500,
  "message": "Internal Server Error",
  "data": {
    "task_id": "gen2abc123def456bksv"
  },
  "workId": "gen2abc123def456bksv"
}

codeExamples

curl
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
  }'
javascript
const response = await fetch('https://udioapi.pro/api/v2/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model: 'chirp-v4-5',
    gpt_description_prompt: 'A upbeat pop song about summer vacation with catchy melody',
    make_instrumental: false,
    gender: 'female',
    style_weight: 0.65,
    weirdness_constraint: 0.65,
    audio_weight: 0.65
  })
});

const data = await response.json();
console.log(data);
javascript
const response = await fetch('https://udioapi.pro/api/v2/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    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
  })
});

const data = await response.json();
console.log(data);