Satu panggilan, media jadi
run mengirim permintaan generasi, melakukan polling dengan backoff yang direkomendasikan API, lalu menghasilkan permintaan yang selesai beserta result.url.
Sekilas info
Mage menerbitkan SDK open source untuk API-nya: @mage-space/sdk di npm untuk TypeScript dan JavaScript, mage-space di PyPI untuk Python, dan paket node comfyui-mage untuk ComfyUI. Masing-masing membungkus REST API dengan konfigurasi bertipe untuk semua 28 model, polling otomatis, percobaan ulang idempoten, dan unggahan.
3
SDK dan integrasi
28
Model bertipe
MIT
Open source
$0
Untuk memasang
Pilih yang cocok
SDK dan integrasi
npm install @mage-space/sdk
SDK TypeScript
Buat gambar, video, dan audio dari Node.js dengan konfigurasi bertipe untuk setiap model Mage. Satu panggilan mengirim, menunggu, dan mengembalikan hasilnya.
pip install mage-space
SDK Python
Buat gambar, video, dan audio dari Python dengan klien sinkron dan asyncio serta konfigurasi bertipe untuk setiap model Mage.
comfy node install comfyui-mage
Mage untuk ComfyUI
Mango, Cherry, Seed Audio, dan semua model Mage lainnya sebagai node ComfyUI. Tanpa GPU, tanpa unduh model.
Mulai cepat
Generasi pertamamu dengan SDK
Pasang paketnya, ekspor MAGE_API_KEY, lalu jalankan sebuah model.
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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
print(request["result"]["url"])Bawaan
Yang ditangani setiap SDK untukmu
Percobaan ulang tanpa bayar dua kali
Setiap pengiriman membawa idempotency key. Error jaringan dan error server dicoba ulang dengan backoff, dan pengiriman ulang tidak pernah ditagih lagi.
Unggah dalam satu panggilan
File yang terlalu besar untuk data URL diunggah lewat unggahan bertanda tangan, dengan tiket, PUT, dan pengecekan ukuran yang diurus untukmu.
Error yang jelas
Penolakan API membawa status HTTP, kode error, dan request id; generasi yang gagal atau dibatalkan serta timeout punya tipe error masing-masing.
Paket
Di mana mendapatkannya
| SDK | Paket | Instal | Sumber |
|---|---|---|---|
| SDK TypeScript | @mage-space/sdk | npm install @mage-space/sdk | GitHub |
| SDK Python | mage-space | pip install mage-space | GitHub |
| Mage untuk ComfyUI | comfyui-mage | comfy node install comfyui-mage | GitHub |
FAQ
Pertanyaan yang sering diajukan
Apakah SDK Mage gratis dan open source?
Ya. SDK dan node ComfyUI berlisensi MIT di GitHub, dan memasangnya gratis. Kamu hanya membayar generasi yang kamu jalankan, dalam Gems, sesuai harga yang tercantum untuk tiap model.
Apakah model Mage baru bisa dipakai dengan SDK versi lama?
Bisa. Berikan id model baru sebagai string, lalu model langsung berjalan; SDK memeriksa konfigurasinya terhadap kolom yang dimiliki semua model. Sebuah bot memperbarui tipe setiap kali referensi API berubah, jadi model baru hadir lengkap dengan tipenya sendiri di rilis berikutnya.
Bagaimana SDK mencegah pembayaran ganda saat permintaan dicoba ulang?
Setiap pengiriman membawa Idempotency-Key. SDK membuat kunci baru untuk setiap panggilan dan memakainya kembali saat SDK mencoba ulang panggilan itu sendiri, sehingga pengiriman yang diulang mengembalikan permintaan asli dan tidak dikenai biaya.
Apakah SDK-nya stabil?
SDK masih dalam versi beta di 0.x, jadi versi minor masih bisa mengubahnya. API-nya sendiri diberi versi terpisah dan tetap stabil di dalam v1.
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.
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.