ElevenLabs Music v1
model-elevenlabs-musicPOST/v1/generationsОриентирот 102 кредитовПопробовать
#Для оценки отправьте то же тело в POST /v1/generations/estimate без Idempotency-Key — ответ покажет costCents и блок billing с кошельком списания. Чтобы сохранить результат в папку, добавьте projectId.
Параметры
#promptstringобязательныйКак должна звучать музыка? — Опишите жанр, настроение, инструменты, темп и развитие композиции.
- По умолчанию
- нет
- Ограничения
- до 5000 символов
music_length_msnumber (enum)необязательныйДлительность
- По умолчанию
60000
Допустимые значения
3000030 секунд600001 минута1200002 минуты1800003 минуты3000005 минут60000010 минут
force_instrumentalbooleanнеобязательныйБез вокала
- По умолчанию
false
output_formatstring (enum)необязательный· расширенныйФормат аудио
- По умолчанию
"mp3_44100_128"
Допустимые значения
mp3_44100_128MP3 · 128 kbpsmp3_44100_192MP3 · 192 kbpspcm_44100PCM · без сжатия
number и boolean — настоящие JSON-числа и логические значения, dimensions — строка из допустимых вариантов, json — JSON-значение или строка с JSON. «Обязательный» относится к активному сценарию: поля других сценариев и поля с невыполненным условием «активно, когда» не проверяются.
Сценарии
#scenario-0по умолчанию
Активные поля: prompt, music_length_ms, force_instrumental, output_format
{
"model": "model-elevenlabs-music",
"values": {
"prompt": "Describe the desired result",
"music_length_ms": 60000,
"force_instrumental": false,
"output_format": "mp3_44100_128"
},
"inputAssets": []
}Цена и результат
#Ориентир при стандартных настройках — 102 кредитов; точная цена зависит от параметров и кошелька, поэтому проверяйте её через estimate. Запуск возвращает HTTP 202, дальше опрашивайте GET /v1/generations/:id раз в 3–5 секунд до completed или failed.
Готовые файлы — в assets[] (url, downloadUrl, mediaAssetId), текст — в textOutput, 3D — в viewerUrl/modelUrl, а выбор форматов скачивания (GLB, FBX, OBJ) — в modelFormats[]. Ответ также содержит prompt, reuseValues, projectId, billingMode и usageUsdMicros. Подробнее — в разделах Запуск и статус и Ошибки и лимиты.
Машиночитаемая схема: GET /v1/generation-models/model-elevenlabs-music. Схема обновляется вместе с каталогом; выключенная модель возвращает 404.