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
Mage menyediakan REST API di https://api.mage.space/v1 dan MCP server jarak jauh di https://mcp.mage.space/mcp untuk developer. Keduanya menjalankan 28 model gambar, video, dan audio yang sama, termasuk Mango 3 dan Cherry 2 Pro yang eksklusif di Mage, dalam satu akun. Setiap generasi dibayar dengan Gems tanpa langganan.
28
Model
3
Jenis media
16
Tool MCP
$0
Biaya bulanan
Cara memulai
Panggil lewat kode, asisten AI, atau ComfyUI
REST API
Mage API
Kirim permintaan generasi dari kodemu sendiri dengan kunci API. Permintaan asinkron, percobaan ulang idempoten, unggahan hingga 100 MB, dan 20 generasi berjalan bersamaan.
SDK
SDK TypeScript dan Python
Klien resmi dengan tipe data yang mengirim permintaan, menunggu hasil, mencoba ulang dengan aman, dan mengunggah file hanya dalam beberapa baris.
MCP server
MCP server Mage
Hubungkan Claude, ChatGPT, Claude Code, Grok, atau Cursor lewat proses masuk, lalu minta gambar, video, dan audio dengan kata-kata biasa.
ComfyUI
Mage untuk ComfyUI
Mango, Cherry, Seed Audio, dan semua model Mage lainnya sebagai node ComfyUI. Tanpa GPU, tanpa unduh model.
Berdasarkan jenis media
API Generasi
Mulai cepat
Generasi pertamamu
Buat kunci di API → API Keys, ekspor sebagai MAGE_API_KEY, lalu jalankan salah satu contoh ini.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3"
}' | 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('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"])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.
MCP
Mage di asisten AI-mu
Mage di Claude
Buat gambar, video, dan audio di Claude versi web, aplikasi desktop, aplikasi seluler, dan Cowork.
Mage di ChatGPT
Buat gambar, video, dan audio di ChatGPT sebagai aplikasi MCP pribadi.
Mage di Claude Code
Buat gambar, video, dan audio di Claude Code, langsung dari terminal dan editor kamu.
Mage di Grok
Buat gambar, video, dan audio di Grok lewat konektor kustom.
Mage di Cursor
Buat gambar, video, dan audio dalam mode Agent di Cursor.
Model
Model unggulan
Gambar · mulai dari 40 Gems
Flux 2 API
Prompt panjang dan edit dengan banyak referensi
Gambar · mulai dari 9 Gems
GPT Image 2 API
Prompt yang presisi dan teks yang terbaca jelas
Gambar · mulai dari 37 Gems
Guava API
Fotorealisme yang tampak seperti foto asli
Gambar · mulai dari 135 Gems
Mango API
Keluarga model gambar andalan kami
Gambar · mulai dari 68 Gems
Nano Banana 2 API
Teks tajam dan mudah dibaca, hingga 4K
Video · mulai dari 618 Gems
Cherry API
Keluarga model video andalan kami
Video · mulai dari 245 Gems
Lemon API
Semua fitur video dengan harga lebih bersahabat
Video · mulai dari 338 Gems
Plum API
Suara di setiap klip, hingga 2K
Audio · mulai dari 19 Gems
Seed Audio API
Suara, musik, dan efek suara dari satu prompt
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.
FAQ
Pertanyaan yang sering diajukan
Apa itu Mage API?
Mage API adalah REST API di https://api.mage.space/v1 untuk membuat gambar, video, dan audio dengan 28 model langsung dari kodemu. Permintaan bersifat asinkron dan dibayar per generasi dengan Gems.
Apa itu server MCP Mage?
Server Model Context Protocol jarak jauh di https://mcp.mage.space/mcp yang memungkinkan asisten AI membuat gambar, video, dan audio di akun Mage kamu. Server ini memberi asisten 16 alat untuk memilih model, menampilkan harga, membuat konten, menunggu hasil, dan memakai karakter, referensi, serta riwayat yang sudah kamu simpan.
Apakah aku perlu kunci API untuk memakai server MCP?
Tidak. Claude, ChatGPT, Grok, Cursor, dan Claude Code terhubung dengan masuk ke Mage lewat OAuth. Kunci API bersifat opsional, untuk setup headless seperti CI.
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.