Eleven Music API

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

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

Для нейросети:Скачать .md Вся документация .md Открыть как текст

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

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

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

cURLPythonNode.js

cURL

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"])

Node.js

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();

Получить ключ

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

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

Режим	Цена
Трек по описанию	от 5 ₽
Музыка под видео с файлом на 1 с	от 1 ₽
Разложить на дорожки с файлом на 1 с	от 1 ₽

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

cURL

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: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле mode.

Трек по описанию mode = song
Музыка под видео mode = video
Разложить на дорожки mode = stems

Трек по описанию

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

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

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

Параметры

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

promptОбязательно: Какая нужна музыка: жанр, настроение, инструменты, темп. Здесь же описывается голос, и здесь же можно дать свои слова песни с указанием языка.
Тип: СтрокаМинимум символов: 1Максимум символов: 4100
modelНеобязательно: Версия модели: 2.5 новейшая, 2 прежняя. Цена одинаковая.
Тип: СтрокаДопустимые значения: music_v2_5По умолчанию: "music_v2_5"
vocalНеобязательно: С вокалом или без голоса. Без голоса модель не принимает negative_prompt, seed, образец звучания и adherence, кроме high.
Тип: СтрокаДопустимые значения: with_vocalsinstrumentalПо умолчанию: "with_vocals"
durationНеобязательно: Длительность трека в секундах, от 10 до 600. Цена растёт вместе с ней.
Тип: Целое числоМинимум: 10Максимум: 600По умолчанию: 60
styleНеобязательно: Готовый стиль из библиотеки ElevenLabs: модель держится его звучания, описание задаёт остальное. none: без стиля.
Тип: СтрокаДопустимые значения: nonehrgo9qt4ebv9ondvrfbymyxkfft8fgqlknydgc9jc8gueokxdvc0websp3mhjhkwafhohc9agcda0cfrcmogtn8kgmqiog8dhexep1ywem2msdf5te27nvsqda3djkopsam0aiywt9prxiuhw6zlkhnmecbjoa1mvwseitetkxqcdgsmkp8qpqqhd6miiqq1sck8hxposlmgjlsj7you9jtua7rsycnbaxci6zvbfumryyjniurf2sy9ee0sdcpenlxjibgjl6wsy1m9zi7osp27p7uzmv4semqmck6dqlnhvs645jaw0kcr5ei0rsjvpjrzgdgqqvyyukiukl7mv1hamfp8dn8witowl0kuaslj0pdvdods2agammwbrhesfql7yrkaaboxnxgpojz144r6sblq1foezx1grqjgx0tz2gjqz9bkewmbsqwy9yr9rgik4fjq83lqetmjawmxfo7j0rhjoh9bcba2y9ttpddnmakxzwpsvoz6njhbsmhfoxlq4iizhs1ude6s5b5xecfqkeuskzyrnjd6p1wkctkwcndwdeg4quj3g28cbyuetrwlgduoyhnzn5nvb246gg7ihzluexd1oy54d4g2rilisuq4dir7rrlyldbl2hzqzhmmiqfkkv39avzbamxnidlsxb9wbecwwrfdsctgfc7ohoxr46pbtqmwpbubel6hpw7kwoqvxf6xixctlh6n3z81aznqz0ohl9pnmgvvvssqtnvoghqncisotr9up85ilbll68sx8s7yvqipbdqc1msstidmcusyisbeh7g7hu3yntwv25afdnzdxqdeszfpxwry2pbeymhinvkahlf4oath9qfug6jrtolcvctpxfjtzt0bpsgsvdptlafmrwao54vrПо умолчанию: "none"
titleНеобязательно: Название трека: встанет в подпись и в имя файла. Не задано: название придумает модель.
Тип: СтрокаМаксимум символов: 80
negative_promptНеобязательно: Чего в музыке быть не должно, через запятую: без барабанов, без крика.
Тип: СтрокаМаксимум символов: 500
adherenceНеобязательно: Насколько строго держаться описания: high почти дословно, low как настроение.
Тип: СтрокаДопустимые значения: highmediumlowПо умолчанию: "high"
seedНеобязательно: Зерно повтора: с тем же числом и теми же настройками результат похож, но не обязательно тот же. Не задано: каждый раз новый вариант.
Тип: Целое числоМинимум: 0Максимум: 2147483647
audio_urlsНеобязательно: Образец звучания: одна ссылка на запись до 30 секунд. Модель возьмёт от неё инструменты, звучание, темп и настроение, жанр образец не меняет. Оплачивается как генерация такой же длины.
Тип: Список (Строка, uri)Максимум элементов: 1
reference_strengthНеобязательно: Насколько сильно образец задаёт звучание. Без образца не действует.
Тип: СтрокаДопустимые значения: lowmediumhighxhighПо умолчанию: "medium"
outputНеобязательно: Формат готового файла: MP3 обычный, MP3 лучшего качества или WAV без потерь. На цену не влияет.
Тип: СтрокаДопустимые значения: mp3_44100_192mp3_48000_320pcm_44100По умолчанию: "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 МБ

Как передать файлы

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

Отправьте этот 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.

Полный пример запуска

Результат

Трек 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"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Музыка под видео

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

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

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

Параметры

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

promptОбязательно: Какая музыка нужна под ролик: настроение, жанр, инструменты.
Тип: СтрокаМинимум символов: 1Максимум символов: 1000
modelНеобязательно: Версия модели: 2.5 новейшая, 2 прежняя. Цена одинаковая.
Тип: СтрокаДопустимые значения: music_v2_5По умолчанию: "music_v2_5"
video_urlsОбязательно: Одна ссылка на ролик. Длина музыки и цена берутся от ролика.
Тип: Список (Строка, uri)Максимум элементов: 1
tagsНеобязательно: Слова о звучании через запятую, до 10: метал, оркестр, быстрый темп. Про сюжет модель и так видит по ролику.
Тип: СтрокаМаксимум символов: 200
titleНеобязательно: Название музыки: встанет в подпись и в имена файлов ролика и музыки. Не задано: файлы будут называться music.
Тип: СтрокаМаксимум символов: 80
outputНеобязательно: Формат готового файла: MP3 или WAV без потерь. MP3 лучшего качества в этом режиме ElevenLabs не отдаёт. На цену не влияет.
Тип: СтрокаДопустимые значения: mp3_44100_192pcm_44100По умолчанию: "mp3_44100_192"
ai_markНеобязательно: Невидимая пометка внутри файла о том, что музыка сделана нейросетью. Звук не меняет, работает только с MP3.
Тип: Да/нетПо умолчанию: false

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

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

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

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

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

Как передать файлы

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

Отправьте этот 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.

Полный пример запуска

Результат

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

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

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"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Разложить на дорожки

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

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

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

Параметры

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

audio_urlsОбязательно: Одна ссылка на запись, которую нужно разложить. Цена по её длительности.
Тип: Список (Строка, uri)Максимум элементов: 1
stemsНеобязательно: Две дорожки: голос и вся остальная музыка. Шесть: голос, барабаны, бас, гитара, клавиши и прочее. Шесть вдвое дороже двух.
Тип: СтрокаДопустимые значения: two_stems_v1six_stems_v1По умолчанию: "two_stems_v1"
outputНеобязательно: Формат готового файла: MP3 или WAV без потерь. MP3 лучшего качества в этом режиме ElevenLabs не отдаёт. На цену не влияет.
Тип: СтрокаДопустимые значения: mp3_44100_192pcm_44100По умолчанию: "mp3_44100_192"
ai_markНеобязательно: Невидимая пометка внутри файла о том, что музыка сделана нейросетью. Звук не меняет, работает только с MP3.
Тип: Да/нетПо умолчанию: false

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

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

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

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

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

Как передать файлы

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

Отправьте этот 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.

Полный пример запуска

Результат

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

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

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"
      }
    ]
  }
}

Как читать результат и скачивать файлы

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

Нейросеть Eleven Music: возможности и цены
Другие версии: Eleven Music v2 API
Похожие модели: Suno V6 API
Документация API
Ошибки API и что с ними делать

Попробуйте Eleven Music через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API