> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elumenta.ru/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Генерируйте музыку через MusicGen (Replicate) и ElevenLabs Music

## Модели

| Слаг               | Провайдер  | Тариф   | Стоимость |
| ------------------ | ---------- | ------- | --------- |
| `musicgen`         | Replicate  | Starter | 9 ткн     |
| `elevenlabs-music` | ElevenLabs | Basic+  | 58 ткн    |

## Запрос

<ParamField header="Authorization" type="string" required>
  `Authorization: Bearer nb_YOUR_API_KEY`
</ParamField>

<ParamField body="model" type="string" required>
  `musicgen` или `elevenlabs-music`
</ParamField>

<ParamField body="prompt" type="string" required>
  Текстовое описание музыки — жанр, настроение, инструменты, темп.

  Пример: `"Энергичный электронный трек с синтезаторами, 128 BPM, танцевальный"`
</ParamField>

<ParamField body="duration" type="integer" default="30">
  Длительность в секундах. Диапазон: `15`–`120`.
</ParamField>

## Ответ

```json theme={null}
{
  "id": "gen_01j9x2abc123",
  "status": "completed",
  "type": "audio",
  "model": "elevenlabs-music",
  "output_url": "https://cdn.elumenta.ru/audio/gen_01j9x2abc123.mp3",
  "duration_seconds": 30,
  "tokens_used": 58,
  "created_at": "2026-03-01T12:00:00Z"
}
```

## Примеры кода

<CodeGroup>
  ```python MusicGen theme={null}
  import requests

  response = requests.post(
      "https://elumenta.ru/api/v2/generate",
      headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
      json={
          "model": "musicgen",
          "prompt": "Спокойный lo-fi хип-хоп, треск винила, фортепиано, 80 BPM",
          "duration": 30
      }
  )
  print(response.json()["output_url"])
  ```

  ```python ElevenLabs Music theme={null}
  import requests

  response = requests.post(
      "https://elumenta.ru/api/v2/generate",
      headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
      json={
          "model": "elevenlabs-music",
          "prompt": "Эпическая оркестровая киномузыка, нарастающее напряжение, полные струнные",
          "duration": 60
      }
  )
  print(response.json()["output_url"])
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://elumenta.ru/api/v2/generate", {
    method: "POST",
    headers: {
      "Authorization": "Bearer nb_YOUR_API_KEY",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      model: "elevenlabs-music",
      prompt: "Энергичный джаз с фортепиано и контрабасом, 120 BPM",
      duration: 45
    })
  });
  const result = await response.json();
  console.log(result.output_url);
  ```
</CodeGroup>

## Советы по промптам

| Цель       | Пример                                                      |
| ---------- | ----------------------------------------------------------- |
| Фон        | `"Мягкая эмбиентная музыка, минимализм, фортепиано и пэды"` |
| Тренировка | `"Энергичный рок, рифф гитары, 140 BPM, мотивирующий"`      |
| Кино       | `"Эпический оркестровый саундтрек, нарастающее напряжение"` |
| Lo-fi      | `"Lo-fi хип-хоп, треск винила, Rhodes пианино, 75 BPM"`     |
| Корпоратив | `"Воодушевляющая корпоративная музыка, лёгкое фортепиано"`  |