Bir bakışta
Mango API, Mango 3 ve diğer 4 varyantı Mage üzerinden POST https://api.mage.space/v1/mango/generate adresinde çalıştırır. Varsayılan ayarlardaki bir istek 135 Gem (yaklaşık 0,135 $) tutar, abonelik gerekmez. Mango, kayıtlı karakterleri alır; referanslar istemde @handle ile verilir.
Görsel
Çıktı
5
Varyantlar
135
Görsel başına Gems, varsayılan
$0.135
Yaklaşık, USD
Genel bakış
Mango API ne yapar?
Tutarlı karakterler, hassas düzenlemeler ve birçok referanstan veya Characters'tan birleştirilen sahneler için görsel ailemiz. Mango 3 ailenin lideri; Mango 3 Turbo en hızlı ve en ucuzu, Mango 3S ise 3K'ya ulaşır.
Mage'in amiral gemisi görsel ailesi; tutarlı karakterler, hassas düzenlemeler ve birçok referanstan birleştirilen sahneler için. Mango 3 (`mango-v3`) güncel modeldir; Mango 3 Turbo (`mango-v3-turbo`) en hızlı ve en ucuzudur, Mango 3S (`mango-v3s`) ise 3K'ya ulaşır.
Girdi olarak image, additional_images kabul eder.
Hızlı başlangıç
Mango API'sini çağırın
MAGE_API_KEY'i ayarla, isteği /mango/generate adresine gönder ve istek tamamlanana kadar status_url'yi sorgula.
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"])Modeller
Mango model_id değerleri
Bir varyant seçmek için model_id gönder. model_id olmadan gönderilen istek varsayılanı çalıştırır.
| model_id | Ad | Varsayılan |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | Evet |
| mango-v3-turbo | Mango 3 Turbo |
Seçenekler
Mango parametreleri
Tüm varyantlar için geçerli değerler; bir varyant daha azını sunabilir. Dokümanlar seçenekleri varyant bazında listeler.
| Alan | Değerler |
|---|---|
| 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 |
Girdiler
Mango'nun kabul ettiği medya girdileri
Her birini https URL'si, data URL'si veya en fazla 100 MB'lık bir yükleme olarak gönder.
| Alan | Rol |
|---|---|
| image | Referans görsel. |
| additional_images | Ek referans görseller. |
Daha fazla görsel modeli
Mage'deki diğer görsel üretim API'leri
Görsel · 68 Gem'den başlayan fiyatlarla
Nano Banana 2 API
Net, okunaklı metin, 4K'ya kadar
Görsel · 15 Gems'ten başlayan fiyatlarla
SDXL Plus API
Yüzleri ve elleri düzeltilmiş SDXL
Görsel · 10 Gems'ten başlayan fiyatlarla
Stable Diffusion v1.5 API
Bütçe dostu klasik
Görsel · 10 Gems'ten başlayan fiyatlarla
Stable Diffusion v3.5 Large API
Söylediğini en iyi anlayan Stable Diffusion
Görsel · 10 Gems'ten başlayan fiyatlarla
Stable Diffusion XL API
Fotogerçekçi sonuçlar için ayarlanmış SDXL
Görsel · 10 Gems'ten başlayan fiyatlarla
Z-Image API
Mage'deki en hızlı görsel modeli
SSS
Sık sorulan sorular
Mango API'sinin maliyeti nedir?
Varsayılan ayarlardaki (Mango 3) bir Mango isteği 135 Gem tutar, yaklaşık 0,135 $. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; yanıt tam ücreti bildirir. Başarısız olan bir üretimin ücreti iade edilir; Mage'in içerik politikası tarafından engellenen üretimin ücreti iade edilmez.
Mango API uç noktası nedir?
Mage API anahtarını taşıyan bir Authorization: Bearer başlığıyla POST https://api.mage.space/v1/mango/generate. Yanıt, sonucu sorgulamak için bir status_url içerir.
Hangi Mango modellerini çağırabilirim?
mango (Mango), mango-v2 (Mango 2), mango-v3s (Mango 3S), mango-v3 (Mango 3), mango-v3-turbo (Mango 3 Turbo). Varsayılan model Mango 3'tür.
Mango referans görsellerini veya karakterleri destekliyor mu?
Mango şunları kabul eder: image, additional_images. Mango, kayıtlı karakterleri alır; referanslar istemde @handle ile verilir.
Mango'yu Claude veya ChatGPT üzerinden kullanabilir miyim?
Evet. Mage MCP sunucusunu Claude, ChatGPT, Claude Code, Grok veya Cursor'a bağla ve Mango'yu adıyla iste. Asistanın seçenekleri get_model ile okur ve üretmeden önce fiyatı söyler.
Mango sonuçları ne kadar süre saklanır?
Sonuçlar ve girdiler 30 gün saklanır. Saklamak istediğin her şeyi kendi depolama alanına indir.
Mage ile geliştirmeye başla
Tek hesap, tek Gems bakiyesi, tüm modeller. Yalnızca ürettiğin kadar öde.