# Eleven Music API

> Музыка Eleven Music от ElevenLabs: трек по описанию с вокалом или без, музыка под ваш ролик и разбор готовой записи на дорожки.

Разработчик: ElevenLabs
Ключ модели в API: `elevenlabs_music`

## Подключение в три шага

1. [Получите ключ](https://api.cyhub.ai/docs/connection.md?lang=ru): Ключ создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
2. [Узнайте цену](https://api.cyhub.ai/docs/generations.md?lang=ru): POST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
3. [Запустите задачу и заберите результат](https://api.cyhub.ai/docs/tasks.md?lang=ru): POST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

## Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.

```bash
curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Спокойная акустическая гитара и мягкие барабаны, женский вокал на русском о летнем вечере у моря",
    "duration": 90,
    "title": "Летний вечер",
    "model": "music_v2_5"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python
import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "elevenlabs_music",
    "settings": {
        "mode": "song",
        "prompt": "Спокойная акустическая гитара и мягкие барабаны, женский вокал на русском о летнем вечере у моря",
        "duration": 90,
        "title": "Летний вечер",
        "model": "music_v2_5",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])
```

```javascript
const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Спокойная акустическая гитара и мягкие барабаны, женский вокал на русском о летнем вечере у моря",
    "duration": 90,
    "title": "Летний вечер",
    "model": "music_v2_5"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();
```

[Получить ключ](https://cyhub.ai/cabinet/keys)

## Цена до запуска

Цены на 15.10.2026: от 1 ₽. Точную цену своих настроек покажет POST /v1/price.

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

```bash
curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Спокойная акустическая гитара и мягкие барабаны, женский вокал на русском о летнем вечере у моря",
    "duration": 90,
    "title": "Летний вечер",
    "model": "music_v2_5"
  }
}'
```

- amount_minor: цена запуска в копейках (для рублей)
- currency: валюта кошелька
- available_minor: сколько сейчас доступно на балансе для новых задач

## <a id="song"></a>Трек по описанию

> Трек по текстовому описанию, с вокалом или без. Можно приложить образец звучания.

Значение поля mode: `song`

Цена в этом режиме от 5 ₽.

### Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

#### `prompt` (Обязательно)

Какая нужна музыка: жанр, настроение, инструменты, темп. Здесь же описывается голос, и здесь же можно дать свои слова песни с указанием языка.

- Тип: Строка
- Минимум символов: 1
- Максимум символов: 4100

#### `model` (Необязательно)

Версия модели: 2.5 новейшая, 2 прежняя. Цена одинаковая.

- Тип: Строка
- Допустимые значения: `music_v2_5` (Версия 2.5)
- По умолчанию: `"music_v2_5"`

#### `vocal` (Необязательно)

С вокалом или без голоса. Без голоса модель не принимает negative_prompt, seed, образец звучания и adherence, кроме high.

- Тип: Строка
- Допустимые значения: `with_vocals` (С вокалом), `instrumental` (Без голоса)
- По умолчанию: `"with_vocals"`

#### `duration` (Необязательно)

Длительность трека в секундах, от 10 до 600. Цена растёт вместе с ней.

- Тип: Целое число
- Минимум: 10
- Максимум: 600
- По умолчанию: `60`

#### `style` (Необязательно)

Готовый стиль из библиотеки ElevenLabs: модель держится его звучания, описание задаёт остальное. none: без стиля.

- Тип: Строка
- Допустимые значения: `none` (Без стиля), `hrgo9qt4ebv9ondvrfby` (Percussive Rhythm), `myxkfft8fgqlknydgc9j` (Cinematic Ambient Atmosphere), `c8gueokxdvc0websp3mh` (Relaxing Ambient), `jhkwafhohc9agcda0cfr` (Whispery Angelic (Female)), `cmogtn8kgmqiog8dhexe` (Deep Hip-Hop Voice (Male)), `p1ywem2msdf5te27nvsq` (18th Century Symphony), `da3djkopsam0aiywt9pr` (Emotional Piano), `xiuhw6zlkhnmecbjoa1m` (Country), `vwseitetkxqcdgsmkp8q` (EDM Dance Pop (Female)), `pqqhd6miiqq1sck8hxpo` ('80s Nu-Disco Revival), `slmgjlsj7you9jtua7rs` (Bass Techno), `ycnbaxci6zvbfumryyjn` (Dark Cinematic), `iurf2sy9ee0sdcpenlxj` (Emo Trap Autotune (Male)), `ibgjl6wsy1m9zi7osp27` (Hard Rock (Male)), `p7uzmv4semqmck6dqlnh` (Hype Hip-Hop), `vs645jaw0kcr5ei0rsjv` (Deep House Groove), `pjrzgdgqqvyyukiukl7m` (High Energy House), `v1hamfp8dn8witowl0ku` (Golden Hour Indie Guitar), `aslj0pdvdods2agammwb` (Indie Dance), `rhesfql7yrkaaboxnxgp` (Angsty Alt Rock (Male)), `ojz144r6sblq1foezx1g` (Melancholic Indie (Male)), `rqjgx0tz2gjqz9bkewmb` (Jazz Hop), `sqwy9yr9rgik4fjq83lq` (Lofi Pulse), `etmjawmxfo7j0rhjoh9b` (Melodic House And Techno), `cba2y9ttpddnmakxzwps` (Metal), `voz6njhbsmhfoxlq4iiz` (Superhero Swell inspired by Stan Lee), `hs1ude6s5b5xecfqkeus` (Brazilian Funk), `kzyrnjd6p1wkctkwcndw` (Commercial Pop), `deg4quj3g28cbyuetrwl` (Power Pop (Male)), `gduoyhnzn5nvb246gg7i` (Upbeat Pop), `hzluexd1oy54d4g2rili` (Y2K RnB Pop (Female)), `suq4dir7rrlyldbl2hzq` (Reggaeton), `zhmmiqfkkv39avzbamxn` ('70s Cambodian Rock), `idlsxb9wbecwwrfdsctg` (Electronic Rock), `fc7ohoxr46pbtqmwpbub` (Gothic Power Rock (Female)), `el6hpw7kwoqvxf6xixct` (Peak Energy), `lh6n3z81aznqz0ohl9pn` (Rock Français), `mgvvvssqtnvoghqnciso` (Emo Trap), `tr9up85ilbll68sx8s7y` (Wooden Slit Drum), `vqipbdqc1msstidmcusy` (Afro House Beats), `isbeh7g7hu3yntwv25af` (Arabic Groove), `dnzdxqdeszfpxwry2pbe` (Baile Beats), `ymhinvkahlf4oath9qfu` (Golden Age Mambo inspired by Celia Cruz), `g6jrtolcvctpxfjtzt0b` (New York Salsa inspired by Celia Cruz), `psgsvdptlafmrwao54vr` (Retro Fanfare inspired by Stan Lee)
- По умолчанию: `"none"`

#### `title` (Необязательно)

Название трека: встанет в подпись и в имя файла. Не задано: название придумает модель.

- Тип: Строка
- Максимум символов: 80

#### `negative_prompt` (Необязательно)

Чего в музыке быть не должно, через запятую: без барабанов, без крика.

- Тип: Строка
- Максимум символов: 500

#### `adherence` (Необязательно)

Насколько строго держаться описания: high почти дословно, low как настроение.

- Тип: Строка
- Допустимые значения: `high` (Строго), `medium` (Средне), `low` (Свободно)
- По умолчанию: `"high"`

#### `seed` (Необязательно)

Зерно повтора: с тем же числом и теми же настройками результат похож, но не обязательно тот же. Не задано: каждый раз новый вариант.

- Тип: Целое число
- Минимум: 0
- Максимум: 2147483647

#### `audio_urls` (Необязательно)

Образец звучания: одна ссылка на запись до 30 секунд. Модель возьмёт от неё инструменты, звучание, темп и настроение, жанр образец не меняет. Оплачивается как генерация такой же длины.

- Тип: Список (Строка, uri)
- Максимум элементов: 1

#### `reference_strength` (Необязательно)

Насколько сильно образец задаёт звучание. Без образца не действует.

- Тип: Строка
- Допустимые значения: `low` (Слабо), `medium` (Средне), `high` (Сильно), `xhigh` (Максимально)
- По умолчанию: `"medium"`

#### `output` (Необязательно)

Формат готового файла: MP3 обычный, MP3 лучшего качества или WAV без потерь. На цену не влияет.

- Тип: Строка
- Допустимые значения: `mp3_44100_192` (MP3, обычный), `mp3_48000_320` (MP3, лучший), `pcm_44100` (WAV без потерь)
- По умолчанию: `"mp3_44100_192"`

#### `lyrics_file` (Необязательно)

Приложить слова песни с таймингом отдельным файлом LRC: для субтитров и караоке.

- Тип: Да/нет
- По умолчанию: `false`

#### `ai_mark` (Необязательно)

Невидимая пометка внутри файла о том, что музыка сделана нейросетью. Звук не меняет, работает только с MP3.

- Тип: Да/нет
- По умолчанию: `false`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

> Эти настройки API задаёт сам, передавать их не нужно: `files_as_is` = `true`

### Входные данные

- Образец звучания передаётся ссылкой на MP3 или WAV до 50 МБ и до 30 секунд и уходит целиком.

| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `audio_urls` | Аудио | mp3, wav | 1 | 50 МБ |

[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)

### Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Песня по описанию

```json
{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Спокойная акустическая гитара и мягкие барабаны, женский вокал на русском о летнем вечере у моря",
    "duration": 90,
    "title": "Летний вечер"
  }
}
```

Музыка без голоса

```json
{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Энергичная электроника для спортивного ролика, быстрый темп",
    "vocal": "instrumental",
    "duration": 30,
    "output": "pcm_44100"
  }
}
```

Трек по образцу звучания

```json
{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "song",
    "prompt": "Тёплый лоу-фай хип-хоп для учёбы, тихий мужской вокал",
    "audio_urls": [
      "https://example.com/reference.mp3"
    ],
    "reference_strength": "high",
    "duration": 60
  }
}
```

Цена считается при приёме задачи, валюта `RUB`.

[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)

### Результат

- Трек MP3 или WAV. У песни со словами ещё и текст песни, по запросу слова с таймингом файлом LRC.

| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `audio` или `document` | mp3, wav | 1 | WAV (output = pcm_44100) приходит как document. |
| `document` | lrc | 0 или 1 | Слова с таймингом: при lyrics_file = true, если в песне есть слова. |

`result.texts`: Слова песни, если в ней есть слова.

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [
      "Текст результата, например слова песни"
    ],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "document",
        "filename": "result.lrc",
        "size": 2097152,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)

## <a id="video"></a>Музыка под видео

> Фоновая музыка под ваш ролик: длина и настроение подбираются по картинке. Музыка здесь всегда без пения.

Значение поля mode: `video`

Цена в этом режиме от 1 ₽, с файлом на 1 с.

### Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

#### `prompt` (Обязательно)

Какая музыка нужна под ролик: настроение, жанр, инструменты.

- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000

#### `model` (Необязательно)

Версия модели: 2.5 новейшая, 2 прежняя. Цена одинаковая.

- Тип: Строка
- Допустимые значения: `music_v2_5` (Версия 2.5)
- По умолчанию: `"music_v2_5"`

#### `video_urls` (Обязательно)

Одна ссылка на ролик. Длина музыки и цена берутся от ролика.

- Тип: Список (Строка, uri)
- Максимум элементов: 1

#### `tags` (Необязательно)

Слова о звучании через запятую, до 10: метал, оркестр, быстрый темп. Про сюжет модель и так видит по ролику.

- Тип: Строка
- Максимум символов: 200

#### `title` (Необязательно)

Название музыки: встанет в подпись и в имена файлов ролика и музыки. Не задано: файлы будут называться music.

- Тип: Строка
- Максимум символов: 80

#### `output` (Необязательно)

Формат готового файла: MP3 или WAV без потерь. MP3 лучшего качества в этом режиме ElevenLabs не отдаёт. На цену не влияет.

- Тип: Строка
- Допустимые значения: `mp3_44100_192` (MP3, обычный), `pcm_44100` (WAV без потерь)
- По умолчанию: `"mp3_44100_192"`

#### `ai_mark` (Необязательно)

Невидимая пометка внутри файла о том, что музыка сделана нейросетью. Звук не меняет, работает только с MP3.

- Тип: Да/нет
- По умолчанию: `false`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

> Эти настройки API задаёт сам, передавать их не нужно: `files_as_is` = `true`

### Входные данные

- Ролик передаётся ссылкой на MP4 до 200 МБ и до 10 минут и уходит целиком.

| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `video_urls` | Видео | mp4 | 1 | 200 МБ |

[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)

### Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Музыка под ролик

```json
{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "video",
    "prompt": "Лёгкая вдохновляющая музыка для ролика о путешествии",
    "tags": "акустика, струнные, светлое настроение",
    "video_urls": [
      "https://example.com/trip.mp4"
    ]
  }
}
```

Цена считается при приёме задачи, валюта `RUB`.

[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)

### Результат

- Ваш ролик с новой музыкой и та же музыка отдельным файлом MP3 или WAV.

| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `video` | mp4 | 1 | Ваш ролик с новой музыкой. |
| `audio` или `document` | mp3, wav | 1 | Та же музыка отдельно, WAV приходит как document. |

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      },
      {
        "index": 1,
        "kind": "audio",
        "filename": "audio.mp3",
        "size": 4194304,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/1"
      }
    ]
  }
}
```

[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)

## <a id="stems"></a>Разложить на дорожки

> Готовая запись раскладывается на отдельные дорожки: голос, барабаны, бас и остальное.

Значение поля mode: `stems`

Цена в этом режиме от 1 ₽, с файлом на 1 с.

### Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

#### `audio_urls` (Обязательно)

Одна ссылка на запись, которую нужно разложить. Цена по её длительности.

- Тип: Список (Строка, uri)
- Максимум элементов: 1

#### `stems` (Необязательно)

Две дорожки: голос и вся остальная музыка. Шесть: голос, барабаны, бас, гитара, клавиши и прочее. Шесть вдвое дороже двух.

- Тип: Строка
- Допустимые значения: `two_stems_v1` (Две дорожки), `six_stems_v1` (Шесть дорожек)
- По умолчанию: `"two_stems_v1"`

#### `output` (Необязательно)

Формат готового файла: MP3 или WAV без потерь. MP3 лучшего качества в этом режиме ElevenLabs не отдаёт. На цену не влияет.

- Тип: Строка
- Допустимые значения: `mp3_44100_192` (MP3, обычный), `pcm_44100` (WAV без потерь)
- По умолчанию: `"mp3_44100_192"`

#### `ai_mark` (Необязательно)

Невидимая пометка внутри файла о том, что музыка сделана нейросетью. Звук не меняет, работает только с MP3.

- Тип: Да/нет
- По умолчанию: `false`

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

> Эти настройки API задаёт сам, передавать их не нужно: `files_as_is` = `true`

### Входные данные

- Запись передаётся ссылкой на MP3 до 50 МБ и до 10 минут и уходит целиком.

| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `audio_urls` | Аудио | mp3 | 1 | 50 МБ |

[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)

### Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Голос отдельно от музыки

```json
{
  "model": "elevenlabs_music",
  "settings": {
    "mode": "stems",
    "audio_urls": [
      "https://example.com/song.mp3"
    ],
    "stems": "two_stems_v1"
  }
}
```

Цена считается при приёме задачи, валюта `RUB`.

[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)

### Результат

- ZIP-архив, в нём каждая дорожка отдельным файлом в выбранном формате.

| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `document` | zip | 1 | Внутри каждая дорожка отдельным файлом MP3 или WAV. |

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

```json
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "document",
        "filename": "result.zip",
        "size": 2097152,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}
```

[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)

## Смотрите также

- [Нейросеть Eleven Music: возможности и цены](https://api.cyhub.ai/models/eleven-music)
- Другие версии: [Eleven Music v2 API](https://api.cyhub.ai/models/eleven-music-v2/api.md)
- Похожие модели: [Suno V6 API](https://api.cyhub.ai/models/suno/api.md)
- [Документация API](https://api.cyhub.ai/docs.md?lang=ru)
- [Ошибки API и что с ними делать](https://api.cyhub.ai/docs/errors.md?lang=ru)