Přeskočit na obsah
PlaygroundDokumentaceZískat API klíč

Mage API · Generování zvuku

API pro generování zvuku pomocí AI: hlasy, hudba a zvuky

Řeč, vyprávění, hudba a zvukové efekty z jednoho promptu díky Seed Audio, s hlasovými referencemi a ovládáním rychlosti řeči, hlasitosti a výšky tónu.

Získat API klíčČíst dokumentaci API
POST https://api.mage.space/v1/{model}/generate

Stručně

Mage API pro generování zvuku provozuje Seed Audio na https://api.mage.space/v1/seed_audio/generate. Pošli textový prompt, volitelně s hlasovými referencemi nebo obrázkem, a získej audio soubor dlouhý až 120 sekund s hlasy, hudbou nebo zvukovými efekty. Každý klip se platí v Gems, bez předplatného.

  • 1audio modely
  • $0.019Nejlevnější výchozí varianta, za klip
  • 20Souběžné generace
  • $0Měsíční poplatek

Modely

Všechny audio modely v Mage API

Ceny jsou za jedno generování, v Gems. 1 000 Gems stojí 1 $ u standardního balíčku a větší balíčky přidávají bonusové Gems. Cena závisí na modelu, rozlišení a délce; zobrazená je cena s výchozím nastavením a každá odpověď uvádí přesnou částku v billing.gems_charged. Selhané generování se vrací; generování zablokované zásadami obsahu Mage ne.

ModelNejlepší proHodnoty model_idVýchozí cena
Seed AudioHlasy, hudba a zvukové efekty z jednoho promptuseed-audio-1.019 Gems ($0.019)

Rychlý start

Generuj zvuk pomocí Seed Audio

Nastav MAGE_API_KEY, odešli požadavek a dotazuj se, dokud se nedokončí. V URL nahraď seed_audio libovolným modelem výše.

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 funguje

Od API klíče k hotovému médiu na tři volání

Všechny modely sdílejí jedno ověřování, jeden asynchronní životní cyklus požadavku a stejné názvy polí.

  1. Vytvoř API klíč

    Přihlas se do Mage, otevři API → API Keys a vytvoř klíč. Začíná na mage_sk_ a zobrazí se jen jednou. Účet může mít 10 aktivních klíčů.

  2. Odešli generování

    Pošli POST s tělem JSON na https://api.mage.space/v1/{model}/generate s hlavičkou Authorization: Bearer. Odpověď přijde okamžitě a obsahuje request_id, status a status_url. Přidej hlavičku Idempotency-Key, aby tě opakování nikdy nestálo platbu navíc.

  3. Zjisti stav a stáhni výsledek

    Dotazuj se na status_url, dokud stav není completed, failed nebo cancelled. Dokončený požadavek obsahuje result.url se souborem obrázku, videa nebo audia, který se uchovává 30 dní.

Stavěné pro ostrý provoz

Co dostane každý požadavek na Mage API

  • Jeden klíč, všechny modely

    28 modelů pro obrázky, video a zvuk za jedním REST API a jedním zůstatkem Gems. Model přepneš změnou cesty v URL.

  • Platíš za každou generaci

    Žádné předplatné ani minimální útrata. Koupíš si Gems a každý požadavek se účtuje podle uvedené ceny. Neúspěšná generace se vrací, pokud ji neblokovaly zásady obsahu Mage.

  • Bezpečné opakování

    Idempotenční klíče zajistí, že opakované odeslání vrátí původní požadavek a nic se neúčtuje podruhé.

  • Konzistentní postavy

    Postavu nebo referenci ulož jednou a pak napiš @handle do libovolného promptu. Použiješ ji s každým modelem, který to podporuje.

  • Velké vstupy

    Obrázky, videa a zvuk můžeš posílat jako URL nebo data URL, případně nahrát soubory do 100 MB přes podepsaný upload.

  • 20 generací najednou

    Každý účet může spustit 20 generací současně a limit lze zvýšit podle tvého případu užití. Odmítnuté požadavky se nikdy neúčtují.

Případy použití

Co vývojáři s audio API vytvářejí

  • Vyprávění a komentář

    Generuj vyprávění pro videa, vysvětlující videa a audioknihy s ovládáním rychlosti řeči, hlasitosti a výšky tónu.

  • Stálé hlasy

    Ulož hlasový klip jako referenci a zmiň ho přes @handle, aby zůstal stejný hlas napříč klipy.

  • Zvukové efekty

    Vytvářej ruchy, foley a zvuky rozhraní z popisu pro hry a aplikace.

  • Hudební podkresy

    Vytvoř z promptu hudbu na pozadí pro krátká videa na sítích a reklamy.

  • Zvuk pro generovaná videa

    Spoj Seed Audio s video API a přidej zvuk ke klipům z modelů bez zvuku.

  • Mluvící agenti

    Nech Claude, ChatGPT nebo vlastního agenta vytvářet zvuk přes MCP server nebo REST API.

Časté dotazy

Často kladené otázky

Umí audio API převod textu na řeč?
Ano. Seed Audio přečte scénář popsaným hlasem nebo uloženou hlasovou referencí a nabízí nastavení rychlosti řeči, hlasitosti a výšky tónu. Ze stejného pole pro prompt umí generovat i hudbu a zvukové efekty.
Jak dlouhý může generovaný zvuk být?
Seed Audio generuje klipy dlouhé až 120 sekund.
Kolik stojí Mage API?
Žádné předplatné ani měsíční poplatek. Každá generace se platí v Gems podle uvedené ceny modelu a 1 000 Gems stojí 1 $ ve standardním balíčku. Stránka každého modelu uvádí cenu při výchozím nastavení a každá odpověď obsahuje přesnou účtovanou částku. Neúspěšná generace se vrací; ta, kterou zablokují zásady obsahu Mage, ne. Požadavek, na který zůstatek nestačí, se odmítne dřív, než se cokoli naúčtuje.
Potřebuji k používání API členství v Mage?
Ne. API funguje jen na Gems. Členské plány a jejich neomezené generování v aplikaci se na požadavky API nevztahují, takže ho může volat jakýkoli účet Mage s Gems.
Můžu výstupy z API používat komerčně?
Ano. Obsah, který v Mage vytvoříš, včetně toho z API a MCP serveru, můžeš používat komerčně. Uvedení autora oceníme, ale není povinné.
Jaké jsou limity požadavků?
Účet může mít najednou 20 generací ve frontě nebo ve zpracování. Odeslání nad tento limit je odmítnuto s chybou 429 a nic nestojí. Pokud chceš limit pro svůj případ navýšit, napiš na [email protected].
Může můj AI agent používat Mage API?
Ano. Agenti mohou volat REST API pomocí klíče nebo se připojit k Mage MCP serveru, který Claude, ChatGPT, Claude Code, Grok a Cursor nabízí šestnáct hotových nástrojů pro výběr modelu, zjištění ceny, generování a stažení výsledku. Podívej se na MCP server.
Existuje SDK pro Mage API?
Ano. Oficiální balíček @mage-space/sdk na npm a mage-space na PyPI jsou open source a mají typy pro každý model. Odešlou požadavek, počkají na výsledek, bezpečně zopakují pokusy a nahrají za tebe soubory. Uživatelé ComfyUI si mohou nainstalovat balík nodů comfyui-mage. Podívej se na Mage SDK.
Už používám jiné API pro generování. Co musím změnit?
Nasměruj klienta na https://api.mage.space/v1, posílej svůj klíč Mage jako Bearer token a namapuj svá pole podle stránky modelu: prompt, aspect_ratio, resolution, duration a model_id fungují stejně u všech modelů Mage. Požadavky jsou asynchronní, takže je odešli a pak opakovaně dotazuj status_url.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.

Získat API klíčČíst dokumentaci API