İçeriğe geç

Mage API · Görsel modeli

Mango API

Amiral gemisi görsel model ailemiz

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

Bir bakışta

Mango API, Mango 4 ve 5 diğer varyantı Mage üzerinden POST https://api.mage.space/v1/mango/generate adresinde çalıştırır. Varsayılan ayarlarla yapılan bir istek 42 Gem (yaklaşık 0,042 $) tutar ve abonelik gerektirmez. Mango, kayıtlı karakterleri ve istem içinde @handle ile verilen referansları kullanabilir.

  • GörselÇıktı
  • 6Varyantlar
  • 42Görsel başına Gems, varsayılan
  • $0.042Yaklaşık, USD

Genel bakış

Mango API ne yapar?

Tutarlı karakterler, hassas düzenlemeler ve birçok referanstan ya da Characters'tan birleştirilen sahneler için görsel model ailemiz. Mango 4 ailenin lideri: en gerçekçi ışık ve cilt dokusunu ve en net küçük yazıları sunar. Mango 3 Turbo referanslar dahil sabit fiyatla taslak üretir, Mango 3S ise 3K'ya ulaşır.

Mage'in amiral gemisi görsel model ailesi: tutarlı karakterler, hassas düzenlemeler ve birçok referanstan birleştirilen sahneler için. Mango 4 (`mango-v4`) varsayılan ve en yeni model; en gerçekçi ışık ve cilt dokusunu ve en net küçük yazıları sunar. Mango 3 (`mango-v3`) bir önceki amiral gemisi, Mango 3 Turbo (`mango-v3-turbo`) referanslar dahil sabit fiyatla taslak üretir, 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-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"])

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 3
mango-v3-turboMango 3 Turbo
mango-v4Mango 4Evet

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 · 15 Gems'ten başlayan fiyatlarla

    MiniMax H3 Image API

    Yerel 16 megapiksel görseller, açık ağırlıklar

  • Görsel · 25 Gems'den başlayan fiyatlarla

    MOSS-Image API

    Uzun prompt'lar ve iki dilli metin, açık ağırlıklar

  • Görsel · 51 Gems'ten 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 · 42 Gem'den başlayan fiyatlarla

    Seedream API

    Seedream, sıkı filtreyle

  • Görsel · 10 Gems'ten başlayan fiyatlarla

    Stable Diffusion v1.5 API

    Bütçe dostu klasik

SSS

Sık sorulan sorular

Mango API'sinin maliyeti nedir?
Varsayılan ayarlarla (Mango 4) yapılan bir Mango isteği 42 Gem, yani yaklaşık 0,042 $ tutar. Diğer çözünürlükler, süreler ve varyantlar fiyatı değiştirir; yanıtta tam ücret belirtilir. Başarısız olan üretimlerin ücreti iade edilir; Mage'in içerik politikası nedeniyle engellenenlerin ü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), mango-v4 (Mango 4). Varsayılan model Mango 4'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.

CharactersTopluluk