Langsung ke konten

Mage API · Model gambar

API Mango

Keluarga model gambar andalan kami

POST https://api.mage.space/v1/mango/generate

Sekilas info

Mango API menjalankan Mango 4 dan 5 varian lainnya lewat Mage di POST https://api.mage.space/v1/mango/generate. Satu permintaan dengan pengaturan default berharga 42 Gems (sekitar $0,042), tanpa langganan. Mango mendukung karakter tersimpan dan referensi lewat @handle di dalam prompt.

  • GambarOutput
  • 6Varian
  • 42Gems per gambar, default
  • $0.042Perkiraan, dalam USD

Ringkasan

Fungsi API Mango

Keluarga model gambar kami untuk karakter yang konsisten, pengeditan presisi, dan adegan yang menggabungkan banyak referensi atau Characters. Mango 4 memimpin keluarga ini, dengan cahaya dan kulit paling realistis serta teks kecil paling tajam; Mango 3 Turbo membuat draf dengan harga tetap, sudah termasuk referensi, dan Mango 3S mencapai 3K.

Keluarga model gambar unggulan Mage, untuk karakter yang konsisten, pengeditan presisi, dan adegan yang menggabungkan banyak referensi. Mango 4 (`mango-v4`) adalah yang default dan terbaru, dengan cahaya dan kulit paling realistis serta teks kecil paling tajam; Mango 3 (`mango-v3`) adalah model unggulan sebelumnya; Mango 3 Turbo (`mango-v3-turbo`) membuat draf dengan harga tetap, sudah termasuk referensi, 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-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"])

Model

Nilai model_id Mango

Kirim model_id untuk memilih varian. Permintaan tanpa model_id akan menjalankan varian default.

model_idNamaDefault
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3
mango-v3-turboMango 3 Turbo
mango-v4Mango 4Ya

Opsi

Parameter Mango

Nilai yang diizinkan untuk semua varian; satu varian bisa menawarkan lebih sedikit. Dokumentasi mencantumkan opsi untuk tiap varian.

KolomNilai
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K, 3K, 4K

Input

Input media yang diterima Mango

Kirim masing-masing sebagai URL https, data URL, atau unggahan hingga 100 MB.

KolomPeran
imageGambar referensi.
additional_imagesGambar referensi tambahan.

Model gambar lainnya

API pembuat gambar lainnya di Mage

FAQ

Pertanyaan yang sering diajukan

Berapa biaya API Mango?
Satu permintaan Mango dengan pengaturan default (Mango 4) berharga 42 Gems, sekitar $0,042. Resolusi, durasi, dan varian lain akan mengubah harganya; biaya pastinya tercantum di respons. Pembuatan yang gagal akan dikembalikan Gems-nya, sedangkan 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), mango-v4 (Mango 4). Defaultnya adalah Mango 4.
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.

CharactersKomunitas