API Uç Noktaları

Müzik Oluştur

POST/v2/generate

Müzik API'si Oluştur

Varsayılan Müzik Yapay zekayla müzik oluşturmak için uç nokta oluşturun. Hem ilham modunu hem de özel modu destekler.

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

tips

Varsayılan uç nokta: Standart oluşturma için /v2/generate kullanın.

Modlar: İlham modu gpt_description_prompt'u kullanır; özel mod istem, stil, başlık'ı kullanır.

Model seçimi: chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 veya chirp-v5-5 arasından seçim yapabilirsiniz. model açıklamaları ve kredi tüketimi bölümüne bakın.

Sonraki adım: Bu uç noktayı çağırdıktan sonra, ilerlemeyi sorgulamak ve ses URL'lerini almak için Müzik Görev Durumu API'si Oluştur kullanın.

requestHeaders

namerequireddescription
AuthorizationyesKimlik doğrulama için taşıyıcı belirteci
Content-Typeyesapplication/json

requestBody

Talep gövdesi İlham Modu veya Özel Modu destekler

İlham Modu

Metin açıklamasından müzik oluşturun

paramNameparamTyperequireddescriptionexample
gpt_description_promptstringyesOluşturmak istediğiniz müziğin metin açıklamasıA upbeat pop song about summer vacation with catchy melody

Özel Mod

Özel şarkı sözleri, stil ve başlıkla müzik oluşturun

paramNameparamTyperequireddescriptionexample
promptstringyesÖzel şarkı sözleri veya ayrıntılı bilgi istemiVerse 1: Walking down the street, feeling so free...
stylestringnoMüzik tarzı veya türüpop, upbeat, electronic, 120 bpm
titlestringnoŞarkı adıSummer Dreams
tagsstringnoKaçınılması gereken negatif etiketlersad, slow

commonParams

paramNameparamTyperequireddescriptionexample
modelstringnoKullanılacak AI modeli.chirp-v5-5
make_instrumentalbooleannoVokal olmadan enstrümantal müzik oluşturunfalse
genderstringnoVokal cinsiyet tercihifemale
style_weightnumbernoStile bağlılığın gücü0.65
weirdness_constraintnumbernoYaratıcı sapmayı kontrol eder0.65
audio_weightnumbernoSes özellikleri için denge ağırlığı0.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);