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

Создание музыки с помощью 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"
  }'