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}/generateW 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.
| Model | Najlepszy do | Wartości model_id | Cena domyślna |
|---|---|---|---|
| Eleven Music | Piosenki ElevenLabs z wokalem lub bez | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: realistyczna mowa, którą możesz reżyserować | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Pełne piosenki z twojego tekstu, otwarte wagi | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Głosy, muzyka i efekty dźwiękowe z jednego promptu | seed-audio-1.0 | 19 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.
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.
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.
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ę?
Jak długi może być wygenerowany dźwięk?
Ile kosztuje Mage API?
Czy potrzebuję członkostwa w Mage, żeby korzystać z API?
Czy mogę używać wyników z API komercyjnie?
Jakie obowiązują limity zapytań?
Czy mój agent AI może korzystać z API Mage?
Czy istnieje SDK do API Mage?
Korzystam już z innego API do generowania. Co muszę zmienić?
Zacznij tworzyć z Mage
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.