Эндпоинты API

Генерация музыки

POST/v2/generate

Создать музыкальный API

Музыка по умолчанию Создайте конечную точку для создания музыки с помощью ИИ. Поддерживает как режим вдохновения, так и пользовательский режим.

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

tips

Конечная точка по умолчанию: используйте /v2/generate для стандартной генерации.

Режимы: В режиме вдохновения используется gpt_description_prompt; пользовательский режим использует подсказку, стиль, title.

Выбор модели: доступны chirp-v4-0, chirp-v4-5, chirp-v4-5-plus, chirp-v5 и chirp-v5-5. См. описание моделей и расход кредитов.

Следующий шаг: после вызова этого endpoint используйте API статуса задачи создания музыки для опроса прогресса и получения URL аудио.

requestHeaders

namerequireddescription
AuthorizationyesТокен носителя для аутентификации
Content-Typeyesapplication/json

requestBody

Тело запроса поддерживает режим вдохновения или пользовательский режим.

Режим вдохновения

Генерировать музыку из текстового описания

paramNameparamTyperequireddescriptionexample
gpt_description_promptstringyesТекстовое описание музыки, которую вы хотите создатьA upbeat pop song about summer vacation with catchy melody

Пользовательский режим

Создавайте музыку с собственными текстами, стилем и названием.

paramNameparamTyperequireddescriptionexample
promptstringyesПользовательские тексты песен или подробные подсказкиVerse 1: Walking down the street, feeling so free...
stylestringnoМузыкальный стиль или жанрpop, upbeat, electronic, 120 bpm
titlestringnoНазвание песниSummer Dreams
tagsstringnoОтрицательные теги, которых следует избегатьsad, slow

commonParams

paramNameparamTyperequireddescriptionexample
modelstringnoМодель искусственного интеллекта для использования.chirp-v5-5
make_instrumentalbooleannoСоздание инструментальной музыки без вокалаfalse
genderstringnoВокальные гендерные предпочтенияfemale
style_weightnumbernoСила следования стилю0.65
weirdness_constraintnumbernoКонтролирует творческое отклонение0.65
audio_weightnumbernoБалансир для аудиофункций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);