API-Endpunkte

Musik generieren

POST/v2/generate

Musik-API generieren

Standard-Musikgenerierungsendpunkt für die KI-Musikerstellung. Unterstützt sowohl den Inspirationsmodus als auch den benutzerdefinierten Modus.

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

tips

Standardendpunkt: Verwenden Sie /v2/generate für die Standardgenerierung.

Modi: Der Inspirationsmodus verwendet gpt_description_prompt; Der benutzerdefinierte Modus verwendet prompt, style, title.

Modellauswahl: Verfügbar sind chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 und chirp-v5-5. Siehe Modellbeschreibung und Credit-Verbrauch.

Nächster Schritt: Nach dem Aufruf dieses Endpunkts nutzen Sie die API zum Generieren des Aufgabenstatus für Musik, um den Fortschritt abzufragen und Audio-URLs abzurufen.

requestHeaders

namerequireddescription
AuthorizationyesInhabertoken zur Authentifizierung
Content-Typeyesapplication/json

requestBody

Der Anforderungstext unterstützt den Inspirationsmodus oder den benutzerdefinierten Modus

Inspirationsmodus

Generieren Sie Musik aus einer Textbeschreibung

paramNameparamTyperequireddescriptionexample
gpt_description_promptstringyesTextbeschreibung der Musik, die Sie generieren möchtenA upbeat pop song about summer vacation with catchy melody

Benutzerdefinierter Modus

Generieren Sie Musik mit benutzerdefinierten Texten, Stilen und Titeln

paramNameparamTyperequireddescriptionexample
promptstringyesBenutzerdefinierte Liedtexte oder ausführliche EingabeaufforderungVerse 1: Walking down the street, feeling so free...
stylestringnoMusikstil oder Genrepop, upbeat, electronic, 120 bpm
titlestringnoSongtitelSummer Dreams
tagsstringnoZu vermeidende negative Tagssad, slow

commonParams

paramNameparamTyperequireddescriptionexample
modelstringnoZu verwendendes KI-Modell.chirp-v5-5
make_instrumentalbooleannoErzeugen Sie Instrumentalmusik ohne Gesangfalse
genderstringnoStimmliche Geschlechtspräferenzfemale
style_weightnumbernoStärke der Stiltreue0.65
weirdness_constraintnumbernoKontrolliert kreative Abweichungen0.65
audio_weightnumbernoAusgleichsgewicht für Audiofunktionen0.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);