Перейти к содержимому

API Mage · Аудиомодель

Eleven Music API

Песни ElevenLabs с вокалом и без

POST https://api.mage.space/v1/eleven_music/generate

Главное

Eleven Music API запускает Eleven Music v2.5 через Mage по адресу POST https://api.mage.space/v1/eleven_music/generate. Запрос с настройками по умолчанию стоит 113 Gems (около $0.113), подписка не нужна. Eleven Music не поддерживает упоминания @handle.

  • АудиоРезультат
  • 1Вариант
  • 113Gems за клип, по умолчанию
  • $0.113Примерно, в USD

Обзор

Что умеет Eleven Music API

Eleven Music от ElevenLabs: песни с текстом и вокалом или инструментальные композиции по описанию, точно той длины, которую вы выберете, до 5 минут.

Музыкальная модель ElevenLabs: песни с вокалом или инструментальные, в виде MP3 точно заданной длительности. Если в промпте указан исполнитель или цитируется текст, защищённый авторским правом, ElevenLabs отклонит его: запрос завершится ошибкой, а оплата вернётся.

Генерирует только по промпту.

Быстрый старт

Вызов Eleven Music API

Задай MAGE_API_KEY, отправь запрос на /eleven_music/generate и опрашивай status_url, пока запрос не завершится.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
  "duration": "30",
  "model_id": "eleven-music-v2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('eleven_music', {
  prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
  duration: '30',
  model_id: 'eleven-music-v2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("eleven_music", {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
    "duration": "30",
    "model_id": "eleven-music-v2.5",
})

print(request["result"]["url"])

Модели

Значения model_id для Eleven Music

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

model_idНазваниеПо умолчанию
eleven-music-v2.5Eleven Music v2.5Да

Параметры

Параметры Eleven Music

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

ПолеЗначения
duration10, 30, 60, 120, 180, 300

Правила

Какие ограничения действуют в Eleven Music API

  • Промпт описывает песню, не более 2000 символов.

Другие аудиомодели

Другие API для генерации аудио в Mage

  • Аудио · от 30 Gems

    Eleven Speech API

    ElevenLabs v4: реалистичная озвучка, которой можно управлять

  • Аудио · от 19 Gems

    Seed Audio API

    Голоса, музыка и звуковые эффекты из одного промпта

FAQ

Частые вопросы

Сколько стоит Eleven Music API?
Запрос к Eleven Music с настройками по умолчанию (Eleven Music v2.5) стоит 113 Gems, около $0.113. Другие разрешения, длительности и варианты меняют цену; точная сумма списания указана в ответе. Если генерация завершилась ошибкой, оплата возвращается; если её заблокировала контентная политика Mage — нет.
Какой эндпоинт у Eleven Music API?
POST https://api.mage.space/v1/eleven_music/generate с заголовком Authorization: Bearer, в котором передаётся твой API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Eleven Music можно вызывать?
eleven-music-v2.5 (Eleven Music v2.5). По умолчанию используется Eleven Music v2.5.
Поддерживает ли Eleven Music референсные изображения или персонажей?
Eleven Music не принимает изображения, видео или аудио на вход. Eleven Music не поддерживает упоминания @handle.
Можно ли использовать Eleven Music из Claude или ChatGPT?
Да. Подключи MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и попроси Eleven Music по названию. Ассистент прочитает доступные параметры через get_model и назовёт цену до начала генерации.
Как долго хранятся результаты Eleven Music?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.