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

Eleven Music v2 API

Музыка Eleven Music v2 от ElevenLabs: трек по описанию с вокалом или без и фоновая музыка под ваш ролик. Трек до 10 минут, можно приложить образец звучания.

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

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

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

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

Готовый код

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

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

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

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

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 ₽

Отправьте те же настройки в 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"
  }
}'
  • amount_minor: цена запуска в копейках (для рублей)
  • currency: валюта кошелька
  • available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

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

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

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

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

На этой странице версия Eleven Music v2: передайте model = music_v2. Без поля model запустится music_v2_5.

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

Параметры

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

promptОбязательно

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

Тип: СтрокаМинимум символов: 1Максимум символов: 4100
modelНеобязательно

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

Тип: СтрокаДопустимые значения: music_v2По умолчанию: "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, wav150 МБ
Как передать файлы

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

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

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

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

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

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

Результат

  • Трек MP3 или WAV. У песни со словами ещё и текст песни, по запросу слова с таймингом файлом LRC.
Вид (kind)ФорматыСколькоПояснение
audio или documentmp3, wav1WAV (output = pcm_44100) приходит как document.
documentlrc0 или 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

На этой странице версия Eleven Music v2: передайте model = music_v2. Без поля model запустится music_v2_5.

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

Параметры

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

promptОбязательно

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

Тип: СтрокаМинимум символов: 1Максимум символов: 1000
modelНеобязательно

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

Тип: СтрокаДопустимые значения: music_v2По умолчанию: "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Видеоmp41200 МБ
Как передать файлы

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

Отправьте этот 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"
    ],
    "model": "music_v2"
  }
}

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

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

Результат

  • Ваш ролик с новой музыкой и та же музыка отдельным файлом MP3 или WAV.
Вид (kind)ФорматыСколькоПояснение
videomp41Ваш ролик с новой музыкой.
audio или documentmp3, wav1Та же музыка отдельно, 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"
      }
    ]
  }
}
Как читать результат и скачивать файлы

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

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

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

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