Przejdź do treści

API Mage · Model audio

Eleven Music API

Piosenki ElevenLabs z wokalem lub bez

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

W skrócie

Eleven Music API uruchamia Eleven Music v2.5 przez Mage pod adresem POST https://api.mage.space/v1/eleven_music/generate. Żądanie z ustawieniami domyślnymi kosztuje 113 Gems (około 0,113 $), bez subskrypcji. Eleven Music nie obsługuje wzmianek @handle.

  • AudioWynik
  • 1Wariant
  • 113Gems za klip, domyślnie
  • $0.113Około, w USD

Przegląd

Co potrafi Eleven Music API

Eleven Music od ElevenLabs: piosenki z tekstem i wokalem albo instrumentalne, tworzone na podstawie opisu, dokładnie takiej długości, jaką wybierzesz, do 5 minut.

Model muzyczny ElevenLabs: utwory z wokalem lub instrumentalne, jako MP3 o dokładnie żądanej długości. Prompt wskazujący wykonawcę lub cytujący tekst chroniony prawem autorskim zostanie odrzucony przez ElevenLabs; żądanie zakończy się błędem, a koszt zostanie zwrócony.

Generuje wyłącznie na podstawie promptu.

Szybki start

Wywołaj Eleven Music API

Ustaw MAGE_API_KEY, wyślij żądanie do /eleven_music/generate i odpytuj status_url, aż żądanie się zakończy.

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

Modele

Wartości model_id dla Eleven Music

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
eleven-music-v2.5Eleven Music v2.5Tak

Opcje

Parametry Eleven Music

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
duration10, 30, 60, 120, 180, 300

Zasady

Jakie ograniczenia egzekwuje Eleven Music API

  • Prompt opisuje utwór i może mieć co najwyżej 2000 znaków.

Więcej modeli audio

Inne API do generowania dźwięku w Mage

  • Audio · od 30 Gems

    Eleven Speech API

    ElevenLabs v4: realistyczna mowa, którą możesz reżyserować

  • Audio · od 19 Gems

    Seed Audio API

    Głosy, muzyka i efekty dźwiękowe z jednego promptu

FAQ

Najczęściej zadawane pytania

Ile kosztuje Eleven Music API?
Żądanie Eleven Music z ustawieniami domyślnymi (Eleven Music v2.5) kosztuje 113 Gems, czyli około 0,113 $. Inne rozdzielczości, długości i warianty zmieniają cenę; dokładny koszt podaje odpowiedź. Nieudana generacja jest zwracana, a zablokowana przez politykę treści Mage nie.
Jaki jest endpoint Eleven Music API?
POST https://api.mage.space/v1/eleven_music/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Eleven Music mogę wywoływać?
eleven-music-v2.5 (Eleven Music v2.5). Domyślnie używany jest Eleven Music v2.5.
Czy Eleven Music obsługuje obrazy referencyjne lub postacie?
Eleven Music nie przyjmuje danych wejściowych w postaci obrazów, wideo ani audio. Eleven Music nie obsługuje wzmianek @handle.
Czy mogę używać Eleven Music w Claude lub ChatGPT?
Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Eleven Music po nazwie. Twój asystent odczyta opcje modelu przez get_model i poda cenę przed wygenerowaniem.
Jak długo przechowywane są wyniki Eleven Music?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.