API Mage · SDK
SDK resmi untuk API Mage
Klien bertipe untuk TypeScript dan Python, serta node Mage untuk ComfyUI. Semua model gambar, video, dan audio AI hanya dengan beberapa baris kode.
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 node pack comfyui-mage untuk ComfyUI. Masing-masing membungkus REST API dengan config bertipe untuk semua 37 model, polling otomatis, retry idempoten, dan upload.
- 3SDK dan integrasi
- 37Model bertipe
- MITOpen source
- $0Untuk memasang
Pilih yang cocok
SDK dan integrasi
npm install @mage-space/sdkSDK 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-spaceSDK Python
Buat gambar, video, dan audio dari Python dengan klien sinkron dan asyncio serta konfigurasi bertipe untuk setiap model Mage.
comfy node install comfyui-mageMage 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-v4',
});
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-v4",
})
print(request["result"]["url"])Bawaan
Yang ditangani setiap SDK untukmu
Satu panggilan, media jadi
run mengirim permintaan generasi, melakukan polling dengan backoff yang direkomendasikan API, lalu menghasilkan permintaan yang selesai beserta result.url.
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?
Apakah model Mage baru bisa dipakai dengan SDK versi lama?
Bagaimana SDK mencegah pembayaran ganda saat permintaan dicoba ulang?
Apakah SDK-nya stabil?
Berapa biaya Mage API?
Apakah aku perlu keanggotaan Mage untuk memakai API?
Bolehkah hasil dari API dipakai untuk tujuan komersial?
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.