Генерация музыки
Создание музыки с помощью Suno
Создание музыки по текстовому описанию с использованием модели Suno.
POST
/v1/suno/generate
Python
import requests
response = requests.post(
"https://api.nixai.ru/v1/suno/generate",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"model": "suno",
"mv": "chirp-v5",
"custom_mode": False,
"opt_description_prompt": "Спокойная инструментальная музыка для медитации"
}
)
result = response.json()
task_id = result["data"]
print(f"Task ID: {task_id}")
Node.js
const response = await fetch('https://api.nixai.ru/v1/suno/generate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'suno',
mv: 'chirp-v5',
custom_mode: false,
opt_description_prompt: 'Спокойная инструментальная музыка для медитации'
})
});
const result = await response.json();
const taskId = result.data;
console.log(`Task ID: ${taskId}`);
cURL
curl -X POST "https://api.nixai.ru/v1/suno/generate" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"mv": "chirp-v5",
"custom_mode": false,
"opt_description_prompt": "Спокойная инструментальная музыка для медитации"
}'
Параметры запроса
- model - Модель для генерации (всегда "suno")
- mv - Версия модели. Доступные значения: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4-5-plus, chirp-v5
- custom_mode - Режим кастомизации (true/false)
- opt_description_prompt - Текстовое описание желаемой музыки (для custom_mode = false)
- title - Название песни (только для custom_mode = true)
- tags - Стиль музыки (только для custom_mode = true)
- prompt - Текст песни (только для custom_mode = true)
- make_instrumental - Создать только инструментальную музыку (true/false)
Режимы работы
1. Пользовательский режим: custom_mode = true
В этом режиме вы можете настроить название песни, стиль и текст, соответствующие полям:
- title - название песни
- tags - стиль музыки
- prompt - текст песни
2. Непользовательский режим: custom_mode = false
В этом режиме вам понадобится только поле opt_description_prompt для описания музыки.
3. Инструментальный контроль
Используйте поле make_instrumental, чтобы указать, следует ли создавать только инструментальную музыку.
Проверка статуса
Используйте полученный task_id для проверки статуса генерации.
POST
/v1/suno/fetch
Python
response = requests.post(
"https://api.nixai.ru/v1/suno/fetch",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"model": "suno",
"id": "f35eac2e-887e-46ae-acae-cb47e5285045"
}
)
result = response.json()
print(result)
Node.js
const response = await fetch('https://api.nixai.ru/v1/suno/fetch', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'suno',
id: 'f35eac2e-887e-46ae-acae-cb47e5285045'
})
});
const result = await response.json();
console.log(result);
cURL
curl -X POST "https://api.nixai.ru/v1/suno/fetch" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno",
"id": "f35eac2e-887e-46ae-acae-cb47e5285045"
}'