Sekilas info
API Mango menjalankan Mango 3 dan 4 varian lainnya lewat Mage di POST https://api.mage.space/v1/mango/generate. Satu permintaan dengan pengaturan default berharga 135 Gems (sekitar $0,135), tanpa langganan. Mango menerima karakter tersimpan dan referensi lewat @handle di prompt.
Gambar
Output
5
Varian
135
Gems per gambar, default
$0.135
Perkiraan, dalam USD
Ringkasan
Fungsi API Mango
Keluarga model gambar kami untuk karakter yang konsisten, pengeditan presisi, dan adegan yang memadukan banyak referensi atau Characters. Mango 3 memimpin keluarga ini; Mango 3 Turbo paling cepat dan paling murah, sedangkan Mango 3S mencapai 3K.
Keluarga model gambar andalan Mage, untuk karakter yang konsisten, pengeditan presisi, dan adegan yang memadukan banyak referensi. Mango 3 (`mango-v3`) adalah model terbaru; Mango 3 Turbo (`mango-v3-turbo`) paling cepat dan paling murah, dan Mango 3S (`mango-v3s`) mencapai 3K.
Menerima image dan additional_images sebagai input.
Mulai cepat
Panggil API Mango
Setel MAGE_API_KEY, kirim ke /mango/generate, lalu polling status_url sampai permintaan selesai.
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"])Model
Nilai model_id Mango
Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.
| model_id | Nama | Default |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | Ya |
| mango-v3-turbo | Mango 3 Turbo |
Opsi
Parameter Mango
Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.
| Kolom | Nilai |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K, 3K, 4K |
Input
Input media yang diterima Mango
Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.
| Kolom | Peran |
|---|---|
| image | Gambar referensi. |
| additional_images | Gambar referensi tambahan. |
Model gambar lainnya
API pembuat gambar lainnya di Mage
Gambar · mulai dari 68 Gems
Nano Banana 2 API
Teks tajam dan mudah dibaca, hingga 4K
Gambar · mulai dari 15 Gems
API SDXL Plus
SDXL dengan wajah dan tangan yang sudah diperbaiki
Gambar · mulai dari 10 Gems
API Stable Diffusion v1.5
Si klasik yang hemat biaya
Gambar · mulai dari 10 Gems
API Stable Diffusion v3.5 Large
Stable Diffusion yang paling patuh pada prompt
Gambar · mulai dari 10 Gems
API Stable Diffusion XL
SDXL yang disetel untuk hasil fotorealistis
Gambar · mulai dari 10 Gems
API Z-Image
Model gambar tercepat di Mage
FAQ
Pertanyaan yang sering diajukan
Berapa biaya API Mango?
Satu permintaan Mango dengan pengaturan default (Mango 3) berharga 135 Gems, sekitar $0,135. Resolusi, durasi, dan varian lain akan mengubah harganya; respons menampilkan biaya pastinya. Generasi yang gagal akan dikembalikan Gems-nya, tetapi yang diblokir oleh kebijakan konten Mage tidak.
Apa endpoint API Mango?
POST https://api.mage.space/v1/mango/generate dengan header Authorization: Bearer yang berisi kunci API Mage kamu. Respons menyertakan status_url untuk di-polling guna mendapatkan hasilnya.
Model Mango apa saja yang bisa kupanggil?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Defaultnya adalah Mango 3.
Apakah Mango mendukung gambar referensi atau karakter?
Mango menerima image, additional_images. Mango menerima karakter tersimpan dan referensi lewat @handle di prompt.
Bisakah aku memakai Mango dari Claude atau ChatGPT?
Bisa. Hubungkan server MCP Mage ke Claude, ChatGPT, Claude Code, Grok, atau Cursor, lalu minta Mango dengan menyebut namanya. Asistenmu membaca opsinya dengan get_model dan menyebutkan harganya sebelum membuat gambar.
Berapa lama hasil Mango disimpan?
Hasil dan input disimpan selama 30 hari. Unduh apa pun yang ingin kamu simpan ke penyimpananmu sendiri.
Mulai berkarya dengan Mage
Satu akun, satu saldo Gems, semua model. Bayar hanya untuk yang kamu buat.