Mage API · Pembuatan gambar
API pembuat gambar AI untuk semua model
Teks ke gambar, edit gambar, dan karakter konsisten dari 18 model, termasuk Mango 4 andalan Mage, lewat satu kunci dan satu saldo.
POST https://api.mage.space/v1/{model}/generateSekilas info
API pembuat gambar AI Mage adalah REST API di https://api.mage.space/v1 yang menjalankan 18 model teks ke gambar dan edit gambar, termasuk Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2, dan Krea 2. Kamu mengirim prompt dengan POST ke /{model}/generate, memantau permintaannya, lalu mengunduh gambarnya. Setiap gambar dibayar dengan Gems, tanpa langganan.
- 18model gambar
- $0.009Default termurah, per gambar
- 20Proses generate bersamaan
- $0Biaya bulanan
Model
Semua model gambar di Mage API
Harga dihitung per proses generate, dalam Gems. 1.000 Gems seharga $1 pada paket standar, dan paket yang lebih besar memberi bonus Gems. Harga bergantung pada model, resolusi, dan durasi; yang ditampilkan adalah harga dengan pengaturan default, dan setiap respons mencantumkan biaya pastinya di billing.gems_charged. Proses generate yang gagal akan dikembalikan Gems-nya; yang diblokir oleh kebijakan konten Mage tidak.
| Model | Terbaik untuk | Nilai model_id | Harga default |
|---|---|---|---|
| Anima | Dibuat khusus untuk anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Open-weights, dibangun di atas Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompt panjang dan edit multi-referensi | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompt presisi dan teks yang terbaca jelas | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, dalam dua tingkatan | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Fotorealisme yang tampak seperti foto sungguhan | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Cepat dan serbaguna, dengan negative prompt | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Estetika memukau dalam hitungan detik | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Keluarga model gambar andalan kami | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Gambar native 16 megapiksel, open weights | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompt panjang dan teks dwibahasa, open weights | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Teks tajam dan terbaca, hingga 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL dengan wajah dan tangan yang sudah diperbaiki | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, dengan filter ketat | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | Yang klasik, hemat biaya | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | Stable Diffusion yang paling patuh pada prompt | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL yang disetel untuk hasil fotorealistis | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | Model gambar tercepat di Mage | z-image-turbo | 10 Gems ($0.01) |
Mulai cepat
Buat gambar dengan Anima v1
Setel MAGE_API_KEY, kirim permintaan, lalu lakukan polling sampai selesai. Ganti anima di URL dengan model mana pun di atas.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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.
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.
Kasus penggunaan
Apa yang dibuat developer dengan API gambar
Gambar produk dan pemasaran
Buat foto produk, varian iklan, dan postingan media sosial kapan saja, dengan teks yang terbaca jelas dari GPT Image 2.6 atau Nano Banana 2.
Karakter yang konsisten
Simpan karakter sekali, lalu pertahankan wajah yang sama di seluruh set gambar dengan Mango 4, Guava 2 Pro, dan model lain yang mendukung mention @handle.
Pipeline pengeditan gambar
Kirim gambar sumber beserta instruksi untuk mengubah persis yang kamu minta dan biarkan sisanya tetap di tempatnya.
Aplikasi dan game
Buat avatar, stiker, kartu, dan adegan langsung di dalam produkmu tanpa perlu menjalankan satu GPU pun.
Potret fotorealistis
Guava 2 Pro menghasilkan potret, fesyen, dan foto gaya hidup dengan kulit, kain, dan cahaya yang terlihat nyata.
Draf cepat dalam skala besar
Z-Image Turbo dan Krea 2 menjaga harga tetap rendah untuk thumbnail bervolume tinggi dan percobaan awal.
FAQ
Pertanyaan yang sering diajukan
Apa API pembuat gambar AI terbaik?
Apakah API gambar mendukung pengeditan gambar dan gambar referensi?
Resolusi apa saja yang didukung API gambar?
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.