POST/generate

Создать API обратного вызова музыки

Создавайте музыку с помощью искусственного интеллекта с поддержкой обратного вызова.

POSThttps://udioapi.pro/api/generate

tips

Эта конечная точка отправляет результаты генерации на ваш URL-адрес обратного вызова.

URL-адрес обратного вызова должен быть общедоступным и принимать запросы POST.

requestHeaders

name	required	description
`Authorization`	yes	Токен носителя для аутентификации
`Content-Type`	yes	application/json

requestBody

Тело запроса поддерживает режим вдохновения или пользовательский режим, а также URL-адрес обратного вызова.

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

Создать из текстового описания

paramName	paramType	required	description	example
`gpt_description_prompt`	`string`	yes	Текстовое описание	`A upbeat pop song about summer vacation with catchy melody`

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

Генерация с пользовательскими текстами, стилем и названием

paramName	paramType	required	description	example
`prompt`	`string`	yes	Пользовательские тексты песен или подсказки	`Verse 1: Walking down the street, feeling so free...`
`style`	`string`	no	Музыкальный стиль	`pop, upbeat, electronic, 120 bpm`
`title`	`string`	no	Название песни	`Summer Dreams`
`tags`	`string`	no	Отрицательные теги	`sad, slow`

commonParams

paramName	paramType	required	description	example
`callback_url`	`string`	yes	Публичный URL-адрес для получения обратных вызовов генерации	`https://your-domain.com/api/callback`
`model`	`string`	no	Модель искусственного интеллекта	`chirp-v5-5`
`make_instrumental`	`boolean`	no	Создание инструментальной музыки	`false`
`gender`	`string`	no	Вокальные гендерные предпочтения	`female`
`style_weight`	`number`	no	Сила приверженности стилю	`0.65`
`weirdness_constraint`	`number`	no	Контроль творческих отклонений	`0.65`
`audio_weight`	`number`	no	Баланс аудиофункций	`0.65`

responses

json

{
  "code": 200,
  "message": "success",
  "workId": "gen2abc123def456bksv",
  "data": {
    "task_id": "gen2abc123def456bksv"
  }
}

codeExamples

curl

curl -X POST "https://udioapi.pro/api/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-domain.com/api/callback",
    "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
  }'