Mage API · Hanggenerálás
Mesterséges intelligencián alapuló hanggenerálás API hangokhoz, zenéhez és hangeffektekhez
Beszéd, narráció, zene és hangeffektek egyetlen promptból a Seed Audióval, hangreferenciákkal, valamint beszédtempó-, hangerő- és hangmagasság-beállításokkal.
POST https://api.mage.space/v1/{model}/generateDióhéjban
A Mage hanggenerálás API a Seed Audiót futtatja a https://api.mage.space/v1/seed_audio/generate címen. Küldj egy szöveges promptot, igény szerint hangreferenciákkal vagy egy képpel, és kapj vissza egy legfeljebb 120 másodperces hangfájlt hangokkal, zenével vagy hangeffektekkel. Minden klip Gemekben fizetendő, előfizetés nélkül.
- 1hangmodell
- $0.019Legolcsóbb alapbeállítás, klipenként
- 20Egyidejű generálások
- $0Havi díj
Modellek
A Mage API összes hangmodellje
Az árak generálásonként értendők, Gemekben. 1000 Gem 1 dollárba kerül a standard csomagban, a nagyobb csomagok bónusz Gemeket adnak. Az ár a modelltől, a felbontástól és a hossztól függ; itt az alapbeállítások szerinti ár látható, a pontos terhelést pedig minden válasz a billing.gems_charged mezőben közli. A sikertelen generálás árát visszatérítjük; azét, amelyet a Mage tartalmi irányelvei blokkolnak, nem.
| Modell | Erre a legjobb | model_id értékek | Alapár |
|---|---|---|---|
| Seed Audio | Hangok, zene és hangeffektek egyetlen promptból | seed-audio-1.0 | 19 Gems ($0.019) |
Gyors kezdés
Hanggenerálás a Seed Audióval
Állítsd be a MAGE_API_KEY értékét, küldd el a kérést, és kérdezd le az állapotát, amíg el nem készül. A fenti modellek bármelyikéhez cseréld ki az URL-ben a seed_audio részt.
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"])Hogyan működik
Az API-kulcstól a kész médiáig három hívással
Minden modell ugyanazt a hitelesítést, ugyanazt az aszinkron kérési életciklust és ugyanazokat a mezőneveket használja.
API-kulcs létrehozása
Jelentkezz be a Mage-be, nyisd meg az API → API-kulcsok oldalt, és hozz létre egy kulcsot. A kulcs mage_sk_ előtaggal kezdődik, és csak egyszer jelenik meg. Egy fiókhoz 10 aktív kulcs tartozhat.
Generálás indítása
Küldj egy JSON törzsű POST kérést a https://api.mage.space/v1/{model}/generate címre Authorization: Bearer fejléccel. A válasz azonnal megérkezik request_id-val, status-szal és status_url-lel. Add meg az Idempotency-Key fejlécet, hogy egy újrapróbálkozás ne kerüljön kétszer pénzbe.
Lekérdezés és letöltés
Kérdezd le a status_url címet, amíg a státusz completed, failed vagy cancelled nem lesz. A befejezett kérés result.url mezője a kép-, videó- vagy hangfájlra mutat, amelyet 30 napig tárolunk.
Éles használatra készült
Mit kap minden Mage API-kérés
Egy kulcs, minden modell
28 kép-, videó- és hangmodell egyetlen REST API és egyetlen Gem-egyenleg mögött. A modellt az URL-útvonal módosításával válthatod.
Generálásonként fizetsz
Nincs előfizetés és minimális költés. Gemeket vásárolsz, és minden kérés a feltüntetett árat terheli. A sikertelen generálás árát visszatérítjük, kivéve, ha a Mage tartalmi irányelvei letiltották.
Biztonságos újrapróbálás
Az idempotencia-kulcsok miatt az újrapróbált beküldés az eredeti kérést adja vissza, újabb terhelés nélkül.
Egységes karakterek
Mentsd el egyszer a karaktert vagy a referenciát, majd írd be a @handle-t bármelyik promptba, és használhatod minden olyan modellel, amely támogatja.
Nagy bemenetek
Küldj kép-, videó- és hangbemeneteket URL-ként vagy data URL-ként, vagy tölts fel akár 100 MB-os fájlokat aláírt feltöltéssel.
20 egyidejű generálás
Minden fiók egyszerre 20 generálást futtathat, és a korlát az igényeidhez igazítva emelhető. Az elutasított kéréseket sosem terheljük.
Felhasználási esetek
Mit építenek a fejlesztők a hang API-val
Narráció és szinkronhang
Generálj narrációt videókhoz, magyarázó anyagokhoz és hangoskönyvekhez, beszédtempó-, hangerő- és hangmagasság-beállításokkal.
Egységes hangok
Mentsd el egy hangklipet referenciaként, és említsd meg @handle-lel, hogy a klipeken át ugyanaz maradjon a hang.
Hangeffektek
Készíts környezeti zajokat, foley-hangokat és felületi hangokat leírásból játékokhoz és alkalmazásokhoz.
Háttérzene
Készíts háttérzenét közösségi médiás klipekhez és hirdetésekhez egy promptból.
Hangsávok generált videókhoz
Használd a Seed Audiót a videó API-val együtt, hogy hangot adj a néma modellekkel készült klipekhez.
Beszélő ágensek
Hagyd, hogy a Claude, a ChatGPT vagy a saját ágensed hangot állítson elő az MCP-szerveren vagy a REST API-n keresztül.
GYIK
Gyakran ismételt kérdések
Tud a hang API szövegfelolvasást?
Milyen hosszú lehet a generált hang?
Mennyibe kerül a Mage API?
Kell Mage-tagság az API használatához?
Felhasználhatom kereskedelmi célra az API kimeneteit?
Mik a sebességkorlátok?
Használhatja az AI-ügynököm a Mage API-t?
Van SDK a Mage API-hoz?
Már használok másik generálási API-t. Mit kell módosítanom?
Kezdj el építeni a Mage-dzsel
Egy fiók, egy Gems-egyenleg, az összes modell. Csak azért fizetsz, amit legenerálsz.