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.

Zdobądź klucz APIPrzeczytaj dokumentację API
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.

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
Seed AudioGłosy, muzyka i efekty dźwiękowe z jednego promptuseed-audio-1.019 Gems ($0.019)

Szybki start

Generuj dźwięk za pomocą Seed Audio

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.

cURL
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"
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('seed_audio', {
  prompt: 'A calm narrator reading a short weather report',
  duration: '5',
  model_id: 'seed-audio-1.0',
});

console.log(request.result.url);
Python
# 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

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

28 modeli obrazu, wideo i audio w jednym REST API i z jednym saldem Gems. Model zmienisz, edytując ścieżkę 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 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.

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.

Zdobądź klucz APIPrzeczytaj dokumentację API

Powiązane