Jeden klucz, wszystkie modele
28 modeli obrazu, wideo i audio w jednym REST API i z jednym saldem Gems. Model zmienisz, edytując ścieżkę URL.
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.
1
modele audio
$0.019
Najtańsza opcja domyślna, za klip
20
Równoczesne generowania
$0
Opłata miesięczna
Modele
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 |
|---|---|---|---|
| Seed Audio | Głosy, muzyka i efekty dźwiękowe z jednego promptu | seed-audio-1.0 | 19 Gems ($0.019) |
Szybki start
Ustaw MAGE_API_KEY, wyślij żądanie i odpytuj, aż zakończy się przetwarzanie. Zamień seed_audio w adresie URL na dowolny model z powyższej listy.
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])Jak to działa
Każdy model korzysta z jednego schematu uwierzytelniania, jednego asynchronicznego cyklu żądania i tych samych nazw pól.
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 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.
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
28 modeli obrazu, wideo i audio w jednym REST API i z jednym saldem Gems. Model zmienisz, edytując ścieżkę URL.
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.
Klucze idempotentności sprawiają, że ponowne wysłanie zapytania zwraca oryginalny wynik i nie pobiera opłaty drugi raz.
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.
Przesyłaj obrazy, wideo i audio jako adresy URL lub data URL albo wgrywaj pliki do 100 MB przez podpisany upload.
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
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.
Zapisz próbkę głosu jako referencję i wywołaj ją przez @handle, aby zachować ten sam głos w wielu klipach.
Twórz dźwięki otoczenia, foley i dźwięki interfejsu na podstawie opisu — do gier i aplikacji.
Twórz muzykę w tle do klipów w mediach społecznościowych i reklam na podstawie promptu.
Połącz Seed Audio z API wideo, aby dodać dźwięk do klipów z modeli bez ścieżki audio.
Pozwól Claude, ChatGPT lub własnemu agentowi tworzyć dźwięk przez serwer MCP lub REST API.
FAQ
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.
Seed Audio generuje klipy do 120 sekund.
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.
Nie. API działa wyłącznie na Gems. Plany członkowskie i ich nielimitowane generowanie w aplikacji nie dotyczą zapytań API, więc może z niego korzystać każde konto Mage z Gems.
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.
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.
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.
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.
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.
Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.