Mage API · Generare audio
API-ul de generare audio cu AI pentru voci, muzică și sunete
Vorbire, narațiune, muzică și efecte sonore dintr-un singur prompt cu Seed Audio, cu referințe vocale și setări pentru viteza vorbirii, volum și înălțimea tonului.
POST https://api.mage.space/v1/{model}/generatePe scurt
API-ul Mage de generare audio rulează Seed Audio la https://api.mage.space/v1/seed_audio/generate. Trimite un prompt text, opțional cu referințe vocale sau o imagine, și primești un fișier audio de până la 120 de secunde cu voci, muzică sau efecte sonore. Fiecare clip se plătește în Gems, fără abonament.
- 1modele audio
- $0.019Cea mai ieftină opțiune implicită, per clip
- 20Generări simultane
- $0Taxă lunară
Modele
Toate modelele audio din Mage API
Prețurile sunt per generare, în Gems. 1.000 de Gems costă $1 în pachetul standard, iar pachetele mai mari adaugă Gems bonus. Prețul depinde de model, rezoluție și durată; se afișează prețul pentru setările implicite, iar fiecare răspuns indică suma exactă în billing.gems_charged. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
| Model | Ideal pentru | Valori model_id | Preț implicit |
|---|---|---|---|
| Seed Audio | Voci, muzică și efecte sonore dintr-un singur prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Pornire rapidă
Generează audio cu Seed Audio
Setează MAGE_API_KEY, trimite cererea și interoghează până se finalizează. Înlocuiește seed_audio din URL cu oricare model de mai sus.
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"])Cum funcționează
De la cheia API la media gata în trei apeluri
Toate modelele folosesc aceeași schemă de autentificare, același ciclu de viață asincron al cererilor și aceleași nume de câmpuri.
Creează o cheie API
Autentifică-te în Mage, deschide API → API Keys și creează o cheie. Începe cu mage_sk_ și este afișată o singură dată. Un cont poate avea 10 chei active.
Trimite o generare
Trimite cu POST un corp JSON la https://api.mage.space/v1/{model}/generate, cu un antet Authorization: Bearer. Răspunsul vine imediat, cu un request_id, un status și un status_url. Trimite un antet Idempotency-Key, ca o reîncercare să nu fie plătită de două ori.
Interoghează și descarcă
Interoghează status_url până când statusul devine completed, failed sau cancelled. O cerere finalizată conține result.url cu fișierul de imagine, video sau audio, păstrat 30 de zile.
Creat pentru producție
Ce primește fiecare cerere către API-ul Mage
O cheie, toate modelele
28 de modele de imagine, video și audio într-un singur API REST și cu un singur sold de Gems. Schimbi modelul modificând calea din URL.
Plătești per generare
Fără abonament și fără cheltuială minimă. Cumperi Gems, iar fiecare cerere costă prețul afișat. O generare eșuată este rambursată, cu excepția cazului în care a fost blocată de politica de conținut Mage.
Reîncercări în siguranță
Cheile de idempotență fac ca o retrimitere să returneze cererea inițială, fără o nouă taxare.
Personaje consecvente
Salvează o dată un personaj sau o referință, apoi scrie @handle în orice prompt ca să le folosești cu fiecare model care le acceptă.
Fișiere de intrare mari
Trimite imagini, video și audio ca URL-uri sau URL-uri de date, sau încarcă fișiere de până la 100 MB printr-o încărcare semnată.
20 de generări simultane
Fiecare cont poate rula 20 de generări în același timp, iar limita poate fi mărită pentru cazul tău de utilizare. Cererile refuzate nu sunt taxate niciodată.
Cazuri de utilizare
Ce construiesc dezvoltatorii cu API-ul audio
Narațiune și voce off
Generează narațiune pentru videoclipuri, prezentări explicative și cărți audio, cu setări pentru viteza vorbirii, volum și înălțimea tonului.
Voci consecvente
Salvează un clip vocal ca referință și menționeaz-o prin @handle ca să păstrezi aceeași voce în toate clipurile.
Efecte sonore
Creează ambianțe, foley și sunete de interfață dintr-o descriere, pentru jocuri și aplicații.
Fundal muzical
Produce muzică de fundal pentru clipuri social media și reclame dintr-un prompt.
Coloane sonore pentru video generat
Combină Seed Audio cu API-ul video ca să adaugi sunet clipurilor create de modele fără audio.
Agenți care vorbesc
Lasă Claude, ChatGPT sau propriul agent să producă audio prin serverul MCP sau prin API-ul REST.
Întrebări frecvente
Întrebări frecvente
Poate API-ul audio să facă text-to-speech?
Cât de lung poate fi audio-ul generat?
Cât costă API-ul Mage?
Am nevoie de un abonament Mage ca să folosesc API-ul?
Pot folosi rezultatele din API în scop comercial?
Care sunt limitele de utilizare?
Poate agentul meu AI să folosească API-ul Mage?
Există un SDK pentru API-ul Mage?
Folosesc deja alt API de generare. Ce trebuie să schimb?
Începe să construiești cu Mage
Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.