Mage API · Dibuat untuk ide berikutnya
Satu API. Tanpa batas kemungkinan.
Hadirkan yang terbaik dari Mage ke produk dan asisten AI-mu. Buat gambar, video, dan audio hanya dengan satu kunci API atau satu koneksi MCP.
https://api.mage.space/v1Sekilas info
Mage menyediakan REST API untuk developer di https://api.mage.space/v1 dan server MCP jarak jauh di https://mcp.mage.space/mcp. Keduanya menjalankan 37 model gambar, video, dan audio yang sama, termasuk Mango 4 dan Cherry 2 Pro yang eksklusif di Mage, dengan satu akun, dan setiap pembuatan dibayar dengan Gems tanpa langganan.
- 37Model
- 3Jenis media
- 16Tool MCP
- $0Biaya bulanan
Cara memulai
Panggil lewat kode, asisten AI, atau ComfyUI
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 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 Mage
Hubungkan Claude, ChatGPT, Claude Code, Grok, atau Cursor lewat proses masuk, lalu minta gambar, video, dan audio dengan kata-kata biasa.
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
API pembuat gambar AI
Teks ke gambar, pengeditan, dan karakter konsisten hingga 4K.
API pembuat video AI
Teks ke video, gambar ke video, frame, referensi, dan suara.
API pembuat audio AI
Suara, narasi, musik, dan efek suara dari satu prompt.
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-v4"
}' | 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-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"])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
Flux 2 API
Prompt panjang dan edit dengan banyak referensi
GPT Image 2 API
Prompt yang presisi dan teks yang terbaca jelas
Guava API
Fotorealisme yang tampak seperti foto asli
Mango API
Keluarga model gambar andalan kami
Nano Banana 2 API
Teks tajam dan mudah dibaca, hingga 4K
Cherry API
Keluarga model video andalan kami
Lemon API
Semua fitur video dengan harga lebih bersahabat
Plum API
Suara di setiap klip, hingga 2K
Seed Audio API
Suara, musik, dan efek suara dari satu prompt
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.
FAQ
Pertanyaan yang sering diajukan
Apa itu Mage API?
Apa itu server MCP Mage?
Apakah aku perlu kunci API untuk memakai server MCP?
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.