Mage API · Görsel modeli

Mango API

Amiral gemisi görsel model ailemiz

API anahtarı alMango'yu playground'da dene
POST https://api.mage.space/v1/mango/generate

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.

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_idAdVarsayılan
mangoMango
mango-v2Mango 2
mango-v3sMango 3S
mango-v3Mango 3Evet
mango-v3-turboMango 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.

AlanDeğerler
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 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.

AlanRol
imageReferans görsel.
additional_imagesEk 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.

API anahtarı alMango'yu playground'da dene

İlgili