Langsung ke konten

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/v1

Sekilas 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

  • 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-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.

  1. 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.

  2. 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.

  3. 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 42 Gems

    Mango API

    Keluarga model gambar andalan kami

  • Gambar · mulai dari 51 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 173 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

  • 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?
Mage API adalah REST API di https://api.mage.space/v1 untuk membuat gambar, video, dan audio dengan 37 model dari kodemu sendiri. Permintaan bersifat asinkron dan dibayar per pembuatan 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 hanya berjalan dengan Gems. Paket keanggotaan dan generasi tanpa batas di dalam aplikasi tidak berlaku untuk permintaan API. Akunmu harus melakukan satu pembayaran yang berhasil terlebih dahulu, baik untuk paket Gem maupun paket langganan apa pun; Gems bonus pendaftaran hanya bisa dipakai di aplikasi Mage.
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.

CharactersKomunitas