Mage API · Pembuatan audio
API pembuat audio AI untuk suara, musik, dan efek suara
Ucapan, narasi, musik, dan efek suara dari satu prompt dengan Seed Audio, lengkap dengan referensi suara serta kontrol kecepatan bicara, volume, dan nada.
POST https://api.mage.space/v1/{model}/generateSekilas info
API pembuat audio Mage menjalankan Seed Audio di https://api.mage.space/v1/seed_audio/generate. Kirim prompt teks, bisa disertai referensi suara atau gambar, lalu terima file audio berdurasi hingga 120 detik berisi suara, musik, atau efek suara. Setiap klip dibayar dengan Gems, tanpa langganan.
- 4model audio
- $0.019Default termurah, per klip
- 20Proses generate bersamaan
- $0Biaya bulanan
Model
Semua model audio di Mage API
Harga dihitung per proses generate, dalam Gems. 1.000 Gems seharga $1 pada paket standar, dan paket yang lebih besar memberi bonus Gems. Harga bergantung pada model, resolusi, dan durasi; yang ditampilkan adalah harga dengan pengaturan default, dan setiap respons mencantumkan biaya pastinya di billing.gems_charged. Proses generate yang gagal akan dikembalikan Gems-nya; yang diblokir oleh kebijakan konten Mage tidak.
| Model | Terbaik untuk | Nilai model_id | Harga default |
|---|---|---|---|
| Eleven Music | Lagu ElevenLabs, dengan atau tanpa vokal | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: suara ucapan senyata manusia yang bisa kamu arahkan | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | Lagu utuh dari liriknya, open weights | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | Suara, musik, dan efek suara dari satu prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Mulai cepat
Buat audio dengan Eleven Music v2.5
Atur MAGE_API_KEY, kirim permintaan, lalu lakukan polling sampai selesai. Ganti eleven_music di URL dengan model mana pun di atas.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | 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('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
print(request["result"]["url"])Cara kerjanya
Dari kunci API sampai media jadi dalam tiga panggilan
Semua model memakai satu skema autentikasi, satu siklus permintaan asinkron, dan nama field yang sama.
Buat kunci API
Masuk ke Mage, buka API → API Keys, lalu buat kunci. Kunci diawali mage_sk_ dan hanya ditampilkan sekali. Satu akun bisa memiliki 10 kunci aktif.
Kirim permintaan generasi
Kirim POST dengan body JSON ke https://api.mage.space/v1/{model}/generate beserta header Authorization: Bearer. Respons langsung kembali dengan request_id, status, dan status_url. Sertakan header Idempotency-Key agar percobaan ulang tidak pernah membayar dua kali.
Cek status dan unduh
Lakukan polling ke status_url sampai statusnya completed, failed, atau cancelled. Permintaan yang selesai membawa result.url berisi file gambar, video, atau audio, yang disimpan selama 30 hari.
Siap untuk produksi
Yang didapat setiap permintaan Mage API
Satu kunci, semua model
37 model gambar, video, dan audio dalam satu REST API dan satu saldo Gems. Ganti model cukup dengan mengubah path URL.
Bayar per generasi
Tanpa langganan dan tanpa minimum pengeluaran. Kamu membeli Gems, lalu setiap permintaan dikenai harga sesuai daftar. Generasi yang gagal akan dikembalikan biayanya, kecuali diblokir oleh kebijakan konten Mage.
Coba ulang dengan aman
Kunci idempotensi membuat pengiriman ulang mengembalikan permintaan asli tanpa dikenai biaya lagi.
Karakter yang konsisten
Simpan karakter atau referensi sekali saja, lalu tulis @handle di prompt mana pun untuk memakainya di semua model yang mendukungnya.
Input berukuran besar
Kirim input gambar, video, dan audio sebagai URL atau data URL, atau unggah file hingga 100 MB lewat unggahan bertanda tangan.
20 generasi berjalan bersamaan
Setiap akun dapat menjalankan 20 generasi sekaligus, dan batasnya bisa dinaikkan sesuai kebutuhanmu. Permintaan yang ditolak tidak pernah dikenai biaya.
Kasus penggunaan
Apa yang dibuat developer dengan API audio
Narasi dan voiceover
Buat narasi untuk video, video penjelasan, dan buku audio, dengan kontrol kecepatan bicara, volume, dan nada.
Suara yang konsisten
Simpan klip suara sebagai referensi dan sebut dengan @handle agar suaranya tetap sama di seluruh klip.
Efek suara
Buat suara ambience, foley, dan UI dari deskripsi untuk game dan aplikasi.
Musik latar
Hasilkan musik latar untuk klip media sosial dan iklan dari sebuah prompt.
Soundtrack untuk video buatan AI
Padukan Seed Audio dengan API video untuk menambahkan suara ke klip dari model tanpa suara.
Agen yang bisa bicara
Biarkan Claude, ChatGPT, atau agen buatanmu menghasilkan audio lewat server MCP atau REST API.
FAQ
Pertanyaan yang sering diajukan
Apakah API audio bisa text-to-speech?
Berapa lama durasi audio yang bisa dibuat?
Berapa biaya Mage API?
Apakah aku perlu keanggotaan Mage untuk memakai API?
Bolehkah hasil dari API dipakai untuk tujuan komersial?
Apa saja rate limit-nya?
Bisakah agen AI-ku memakai API Mage?
Apakah ada SDK untuk API Mage?
Aku sudah memakai API generasi lain. Apa yang perlu kuubah?
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.