Satu kunci, semua model
28 model gambar, video, dan audio dalam satu REST API dengan satu saldo Gems. Ganti model cukup dengan mengubah path URL.
Sekilas 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.
1
model audio
$0.019
Default termurah, per klip
20
Proses generate bersamaan
$0
Biaya 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 |
|---|---|---|---|
| Seed Audio | Suara, musik, dan efek suara dari satu prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Mulai cepat
Buat audio dengan Seed Audio
Atur MAGE_API_KEY, kirim permintaan, lalu lakukan polling sampai selesai. Ganti seed_audio di URL dengan model mana pun di atas.
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"])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
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?
Bisa. Seed Audio membacakan naskah dengan suara yang kamu deskripsikan, atau dengan referensi suara yang tersimpan, dan menyediakan pengaturan kecepatan bicara, volume, dan nada. Seed Audio juga membuat musik dan efek suara dari kolom prompt yang sama.
Berapa lama durasi audio yang bisa dibuat?
Seed Audio membuat klip hingga 120 detik.
Berapa biaya Mage API?
Tidak ada langganan atau biaya bulanan. Setiap generasi dibayar dengan Gems sesuai harga model tersebut, dan 1.000 Gems seharga $1 pada paket standar. Setiap halaman model mencantumkan harga dengan pengaturan default, dan setiap respons menyebutkan biaya yang tepat. Generasi yang gagal akan dikembalikan biayanya; yang diblokir oleh kebijakan konten Mage tidak. Permintaan yang tidak bisa ditutup oleh saldomu akan ditolak sebelum ada biaya yang dikenakan.
Apakah aku perlu keanggotaan Mage untuk memakai API?
Tidak. API berjalan hanya dengan Gems. Paket keanggotaan beserta generasi tanpa batas di dalam aplikasi tidak berlaku untuk permintaan API, jadi akun Mage mana pun yang punya Gems bisa memakainya.
Bolehkah hasil dari API dipakai untuk tujuan komersial?
Ya. Konten yang kamu buat dengan Mage, termasuk lewat API dan server MCP, boleh dipakai secara komersial. Atribusi kami hargai, tetapi tidak wajib.
Apa saja rate limit-nya?
Satu akun dapat memiliki 20 proses generate yang mengantre atau berjalan sekaligus. Pengiriman di atas batas itu ditolak dengan kode 429 dan tidak dikenai biaya. Tulis ke [email protected] untuk menaikkan batas sesuai kebutuhanmu.
Bisakah agen AI-ku memakai API Mage?
Bisa. Agen dapat memanggil REST API dengan kunci, atau terhubung ke server MCP Mage, yang memberi Claude, ChatGPT, Claude Code, Grok, dan Cursor enam belas tool siap pakai untuk memilih model, menghitung harga, membuat konten, dan mengambil hasilnya. Lihat server MCP.
Apakah ada SDK untuk API Mage?
Ada. Paket resmi @mage-space/sdk di npm dan mage-space di PyPI bersifat open source dan bertipe untuk setiap model. Keduanya mengirim permintaan, menunggu hasil, mencoba ulang dengan aman, dan mengunggah file untukmu. Pengguna ComfyUI bisa memasang node pack comfyui-mage. Lihat SDK Mage.
Aku sudah memakai API generasi lain. Apa yang perlu kuubah?
Arahkan kliennmu ke https://api.mage.space/v1, kirim kunci Mage sebagai Bearer token, dan petakan field-mu ke halaman model: prompt, aspect_ratio, resolution, duration, dan model_id bekerja dengan cara yang sama di semua model Mage. Permintaan bersifat asinkron, jadi kirim dulu, lalu lakukan polling ke status_url.
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.