Przejdź do treści

Mage API · Generowanie dźwięku

API do generowania dźwięku AI: głosy, muzyka i efekty dźwiękowe

Mowa, narracja, muzyka i efekty dźwiękowe z jednego promptu dzięki Seed Audio, z próbkami głosu oraz ustawieniami tempa mowy, głośności i wysokości dźwięku.

POST https://api.mage.space/v1/{model}/generate

W skrócie

API Mage do generowania dźwięku uruchamia Seed Audio pod adresem https://api.mage.space/v1/seed_audio/generate. Wyślij prompt tekstowy, opcjonalnie z próbkami głosu lub obrazem, i otrzymaj plik audio do 120 sekund z głosami, muzyką lub efektami dźwiękowymi. Każdy klip płacisz w Gems, bez subskrypcji.

  • 4modele audio
  • $0.019Najtańsza opcja domyślna, za klip
  • 20Równoczesne generowania
  • $0Opłata miesięczna

Modele

Wszystkie modele audio w Mage API

Ceny są za jedno generowanie, w Gems. 1000 Gems kosztuje 1 USD w standardowym pakiecie, a większe pakiety dodają bonusowe Gems. Cena zależy od modelu, rozdzielczości i czasu trwania; pokazujemy cenę dla ustawień domyślnych, a dokładną opłatę podaje każda odpowiedź w billing.gems_charged. Nieudane generowanie jest zwracane; zablokowane przez zasady treści Mage — nie.

ModelNajlepszy doWartości model_idCena domyślna
Eleven MusicPiosenki ElevenLabs z wokalem lub bezeleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: realistyczna mowa, którą możesz reżyserowaćeleven-v430 Gems ($0.03)
MiniMax Music 3Pełne piosenki z twojego tekstu, otwarte wagiminimax-music-3125 Gems ($0.125)
Seed AudioGłosy, muzyka i efekty dźwiękowe z jednego promptuseed-audio-1.019 Gems ($0.019)

Szybki start

Generuj audio z Eleven Music v2.5

Ustaw MAGE_API_KEY, wyślij żądanie i odpytuj, aż się zakończy. Zamień eleven_music w adresie URL na dowolny model z powyższych.

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

Jak to działa

Od klucza API do gotowego pliku w trzech wywołaniach

Każdy model korzysta z jednego schematu uwierzytelniania, jednego asynchronicznego cyklu żądania i tych samych nazw pól.

  1. Utwórz klucz API

    Zaloguj się do Mage, otwórz API → API Keys i utwórz klucz. Zaczyna się od mage_sk_ i jest wyświetlany tylko raz. Konto może mieć 10 aktywnych kluczy.

  2. Wyślij generację

    Wyślij POST z ciałem JSON na https://api.mage.space/v1/{model}/generate z nagłówkiem Authorization: Bearer. Odpowiedź przychodzi od razu i zawiera request_id, status oraz status_url. Dodaj nagłówek Idempotency-Key, aby ponowienie nigdy nie kosztowało podwójnie.

  3. Sprawdzaj status i pobierz plik

    Odpytuj status_url, aż status zmieni się na completed, failed lub cancelled. Zakończone żądanie zawiera result.url z plikiem obrazu, wideo lub audio, który jest przechowywany przez 30 dni.

Stworzone do produkcji

Co dostaje każde zapytanie do Mage API

  • Jeden klucz, wszystkie modele

    37 modeli do obrazów, wideo i dźwięku w jednym REST API i z jednym saldem Gems. Model zmienisz, zmieniając ścieżkę w URL.

  • Płać za generację

    Bez subskrypcji i minimalnych wydatków. Kupujesz Gems, a każde zapytanie kosztuje tyle, ile wskazuje cennik. Za nieudaną generację zwracamy koszt, chyba że zablokowała ją polityka treści Mage.

  • Bezpieczne ponowienia

    Klucze idempotentności sprawiają, że ponowne wysłanie zapytania zwraca oryginalny wynik i nie pobiera opłaty drugi raz.

  • Spójne postacie

    Zapisz postać lub referencję raz, a potem wpisz @handle w dowolnym prompcie, by użyć jej w każdym modelu, który to obsługuje.

  • Duże dane wejściowe

    Przesyłaj obrazy, wideo i audio jako adresy URL lub data URL albo wgrywaj pliki do 100 MB przez podpisany upload.

  • 20 generacji naraz

    Każde konto może uruchomić 20 generacji jednocześnie, a limit można zwiększyć na potrzeby Twojego projektu. Odrzucone zapytania nigdy nie są płatne.

Zastosowania

Co programiści tworzą za pomocą API audio

  • Narracja i lektor

    Generuj narrację do filmów, materiałów objaśniających i audiobooków, z ustawieniami tempa mowy, głośności i wysokości dźwięku.

  • Spójne głosy

    Zapisz próbkę głosu jako referencję i wywołaj ją przez @handle, aby zachować ten sam głos w wielu klipach.

  • Efekty dźwiękowe

    Twórz dźwięki otoczenia, foley i dźwięki interfejsu na podstawie opisu — do gier i aplikacji.

  • Podkłady muzyczne

    Twórz muzykę w tle do klipów w mediach społecznościowych i reklam na podstawie promptu.

  • Ścieżki dźwiękowe do wygenerowanych filmów

    Połącz Seed Audio z API wideo, aby dodać dźwięk do klipów z modeli bez ścieżki audio.

  • Agenci, którzy mówią

    Pozwól Claude, ChatGPT lub własnemu agentowi tworzyć dźwięk przez serwer MCP lub REST API.

FAQ

Najczęściej zadawane pytania

Czy API audio potrafi zamieniać tekst na mowę?
Tak. Seed Audio czyta skrypt opisanym głosem lub zapisaną próbką głosu i udostępnia ustawienia tempa mowy, głośności i wysokości dźwięku. Z tego samego pola promptu generuje też muzykę i efekty dźwiękowe.
Jak długi może być wygenerowany dźwięk?
Seed Audio generuje klipy do 120 sekund.
Ile kosztuje Mage API?
Nie ma subskrypcji ani opłaty miesięcznej. Każda generacja jest płatna w Gems według ceny danego modelu, a 1000 Gems kosztuje 1 USD w standardowym pakiecie. Strona każdego modelu podaje cenę przy ustawieniach domyślnych, a każda odpowiedź zawiera dokładną kwotę opłaty. Za nieudaną generację zwracamy koszt, ale nie w przypadku zablokowania jej przez politykę treści Mage. Zapytanie, na które nie wystarcza Twojego salda, zostanie odrzucone, zanim cokolwiek zostanie pobrane.
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Nie. API działa wyłącznie na Gemach. Plany członkowskie i ich nielimitowane generowanie w aplikacji nie obejmują zapytań API. Konto musi mieć najpierw jedną udaną płatność – za dowolny pakiet Gemów lub plan; Gemy z bonusu za rejestrację działają tylko w aplikacji Mage.
Czy mogę używać wyników z API komercyjnie?
Tak. Treści tworzone w Mage, także przez API i serwer MCP, możesz wykorzystywać komercyjnie. Podanie autorstwa jest mile widziane, ale nie jest wymagane.
Jakie obowiązują limity zapytań?
Na jednym koncie może być jednocześnie w kolejce lub w trakcie 20 generowań. Zgłoszenie ponad limit zostanie odrzucone z kodem 429 i nic nie kosztuje. Napisz na [email protected], aby podnieść limit dla swojego zastosowania.
Czy mój agent AI może korzystać z API Mage?
Tak. Agenci mogą wywoływać REST API za pomocą klucza albo połączyć się z serwerem MCP Mage, który daje Claude, ChatGPT, Claude Code, Grok i Cursor szesnaście gotowych narzędzi do wyboru modelu, sprawdzenia ceny, generowania i pobrania wyniku. Zobacz serwer MCP.
Czy istnieje SDK do API Mage?
Tak. Oficjalne pakiety @mage-space/sdk na npm i mage-space na PyPI są open source i mają typy dla każdego modelu. Wysyłają zlecenia, czekają na wynik, bezpiecznie ponawiają próby i przesyłają za Ciebie pliki. Użytkownicy ComfyUI mogą zainstalować zestaw węzłów comfyui-mage. Zobacz SDK Mage.
Korzystam już z innego API do generowania. Co muszę zmienić?
Skieruj klienta na https://api.mage.space/v1, wysyłaj swój klucz Mage jako token Bearer i dopasuj pola do strony modelu: prompt, aspect_ratio, resolution, duration i model_id działają tak samo we wszystkich modelach Mage. Żądania są asynchroniczne, więc wyślij je, a potem odpytuj status_url.

Zacznij tworzyć z Mage

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

CharactersSpołeczność