how-tos

MAI Image 2.7 API Şeffaf Arka Plan: PNG ve WebP Görseller

Poyo.ai Team
7 min read
Share:

MAI Image 2.7 API'den şeffaf PNG ve WebP görseller

MAI Image 2.7 API gerçek bir alfa kanalına sahip görseller döndürebilir; böylece ürün dekupajları, logolar, ikonlar ve çıkartmalar maskeleme adımı olmadan her arka plana yerleştirilmeye hazır gelir. PoYo'da bunun için mai-image-2.7 veya mai-image-2.7-flash üzerinde iki alan yeterlidir: background ve output_format. Lansman günü testimizde Flash'ta şeffaf 1024x1024 bir PNG, güncel oranlarla 2.062 kredi, yaklaşık $0.0103 tutuyor. Koda bağlamadan önce MAI Image 2.7 model sayfasında deneyin.

Microsoft şeffaflık hakkında ne diyor?

Microsoft'un lansman yazısı "iki modelin de kullanıma hazır ürün görselleri için şeffaf arka planları desteklediğini" söylüyor ve logoları, ikonları ve illüstrasyonları diğer kullanım alanları olarak sayıyor. Microsoft'un Foundry dokümantasyonu şeffaf arka planı, MAI-Image-2.7'nin önceki MAI görsel modellerine göre eklediği bir yetenek olarak listeliyor: "ürün görselleri, logolar, ikonlar ve başka içeriklerin üzerine yerleştirilmesi gereken tasarım öğeleri gibi görseller için". MAI Image 2.6'da böyle bir seçenek yok.

İki alan

AlanDeğerlerVarsayılanKural
backgroundopaque, transparentopaquetransparent, alfa kanallı bir görsel döndürür
output_formatpng, jpeg, webppngtransparent için png veya webp gerekir

Varsayılanlar opaque ve png olduğundan, şeffaflık için background alanını açıkça göndermeniz gerekir. PNG için output_format atlanabilir, ama göndermek niyeti loglarda netleştirir. "background": "transparent" ile "output_format": "jpeg" geçersizdir, çünkü JPEG'in alfa kanalı yoktur; bu kombinasyonun gönderimden önce başarısız olması için kendi tarafınızda doğrulayın.

Diğer tüm alanlar her zamanki gibi çalışır: size (varsayılan 1:1, herhangi bir ön ayar oranı veya 4,194,304 piksele kadar özel bir WIDTHxHEIGHT), resolution (1K veya 2K) ve isteğe bağlı bir callback_url. Tam alan kuralları API referansında.

İstek gövdeleri

MAI Image 2.7 API ile şeffaf PNG

Flash'ta 1K kare bir çıkartma, ölçtüğümüz çalıştırmayla aynı alan ayarlarıyla (prompt bir örnektir):

curl https://api.poyo.ai/api/generate/submit \
  -H "Authorization: Bearer $POYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7-flash",
    "input": {
      "prompt": "A cute cartoon sticker of a smiling coffee cup with a thick white outline, centered, no background",
      "size": "1:1",
      "resolution": "1K",
      "background": "transparent",
      "output_format": "png"
    }
  }'

Şeffaf WebP logo

PoYo dokümantasyonundaki örnek, amiral gemisinde:

{
  "model": "mai-image-2.7",
  "input": {
    "prompt": "A flat vector logo of a red fox head, clean edges, no background",
    "background": "transparent",
    "output_format": "webp"
  }
}

WebP de alfa taşır ve genellikle PNG'den daha küçük dosyalar verir; bu da web sayfalarına uygundur. PNG ise baskı iş akışları ve onu bekleyen tasarım araçları için daha güvenli seçimdir.

İki istek de bir task_id döndürür. status değeri finished olana kadar GET https://api.poyo.ai/api/generate/status/{task_id} adresini sorgulayın, ardından data.files[0].file_url dosyasını indirin. MAI Image 2.7 API rehberinde eksiksiz bir sorgulama döngüsü var.

Ölçüm: lansman günü şeffaf bir çıkartma

PoYo ekibi bunu 19 Kasım 2026'da PoYo üretim API'sinde çalıştırdı:

AyarDeğer
Modelmai-image-2.7-flash
Alanlarsize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
Çıktı1024x1024 PNG, RGBA
Arka planGerçek alfa: nesnenin etrafı tamamen şeffaf
Güncel oranlarla maliyet2.062 kredi (yaklaşık $0.0103)
SüreYaklaşık 42 sn, birkaç saniyede bir sorgulamayla gönderimden sonuca

Türetilmiş tahmin: 1024x1024, 1M başına 2,000 krediden yaklaşık 1,024 çıktı token'ıdır, yani 2.048 kredi; kalan 0.014 kredi, 1M başına 350 krediden yaklaşık 40 prompt token'ına karşılık gelir. Başka bir deyişle şeffaf görsel, o boyuttaki diğer tüm görseller gibi ücretlendirildi. Fiyat listesinde şeffaflık için ek ücret yok.

Alfa kanalını kodda kontrol edin

Dosya uzantısına güvenmeyin: indirilen görselin varlık kütüphanenize girmeden önce gerçekten şeffaf piksellere sahip olduğunu doğrulayın. Pillow ile:

import io
import requests
from PIL import Image

def check_transparency(file_url):
    data = requests.get(file_url, timeout=60).content
    img = Image.open(io.BytesIO(data))
    if img.mode != "RGBA":
        img = img.convert("RGBA")
    alpha = img.getchannel("A")
    lo, hi = alpha.getextrema()
    clear = sum(1 for a in alpha.getdata() if a == 0)
    share = clear / (img.width * img.height)
    print(img.size, img.mode, "alpha range", (lo, hi), f"{share:.0%} fully transparent")
    return lo == 0 and share > 0.05

lo == 0 ve kayda değer oranda tamamen şeffaf piksel içeren bir sonuç, kullanılabilir bir dekupaj demektir. Dama deseni çizilmiş bir resim ise lo == 255 gösterir, yani her piksel opaktır. Eşiği kendi görsellerinize göre seçin: tüm kareyi dolduran bir illüstrasyonda, ortalanmış bir ikona göre daha az boş alan olur.

Temiz dekupajlar için prompt yazımı

Alfa kanalını model halleder; nesnenin ne kadar kolay ayrılacağını ise yine prompt belirler.

  • Nesnenin tek başına olduğunu söyleyin. PoYo dokümantasyonundaki örnek "clean edges, no background" ile bitiyor. Microsoft'un şeffaf görsel için Foundry örneği "full body, centered, no shadow" kullanıyor.
  • Sahne kelimelerinden kaçının. "On a table", "in a studio" veya "with a shadow" nesnenin dışında kalan şeyler ister.
  • Çıkartmalarda dış çizgi isteyin. Kalın beyaz bir kenar hem açık hem koyu arka planlarda iyi görünür.
  • Her metni tırnak içine alın. Görselde bir kelime veya logo metni varsa, dokümantasyonun görsel içi metin için önerdiği gibi tırnak içine alın.

Yüksek hacimde şeffaf görsellerin maliyeti

Çıktı token'ları yalnızca piksel sayısına bağlıdır, bu yüzden şeffaflık opak çıktıyla aynı maliyettedir. Görsel başına çıktı token'ı maliyeti:

BoyutMAI Image 2.7MAI Image 2.7 Flash
1024x1024 (1:1, 1K)6.96 kredi ($0.0348)2.05 kredi ($0.0102)
2048x2048 (1:1, 2K)27.85 kredi ($0.1393)8.19 kredi ($0.0410)

Flash çıkartması başına ölçülen 2.062 krediyle 1,000 çıkartma yaklaşık 2,062 kredi, kabaca $10.31 eder. İkon setleri ve katalog dekupajları için Flash'ı, marka logosu veya ana ürün görseli gibi tek bir görselin olabildiğince iyi olması gerektiğinde MAI Image 2.7'yi kullanın. Fiyat yazısı ve Flash ile 2.7 karşılaştırması daha ayrıntılı bilgi veriyor.

Yaygın şeffaf görsel işleri için ayarlar

İşModelsize / resolutionoutput_format
Toplu sohbet veya uygulama çıkartmalarımai-image-2.7-flash1:1, 1Kpng veya webp
Web sitesi ikonları ve illüstrasyonlarımai-image-2.7-flash1:1, 1Kwebp
E-ticaret ürün dekupajlarımai-image-2.71:1 veya 3:4, 2Kpng
Baskı ve sunumlar için marka logosumai-image-2.71:1, 2Kpng
Hero görselinin üzerine bindirilecek geniş banner öğesimai-image-2.7Özel, ör. 3072x1344webp

Bunlar kural değil, başlangıç noktalarıdır: her satır yalnızca belgelenmiş alanları kullanır, bu yüzden istekteki başka hiçbir şeyi değiştirmeden bir işi katmanlar veya boyutlar arasında taşıyabilirsiniz. Her yeni iş türünün ilk partisinde alfa kontrolünü çalıştırın.

Şeffaf sonuçla düzenleme

Şema, background: "transparent" alanını image_urls ile birlikte kullanmaya da izin verir; örneğin bir ürün fotoğrafını dekupaja dönüştürmek veya mevcut bir çıkartmayı alfa kanalını koruyarak yeniden stillendirmek için. Bu kombinasyonu henüz ölçmedik; bu yüzden üretimde güvenmeden önce birkaç kendi görselinizde test edin ve yukarıdaki alfa kontrolünü çalıştırın.

Sık sorulan sorular

MAI Image 2.7 API'den nasıl şeffaf arka plan alırım? input içinde "background": "transparent" ve "output_format": "png" (veya "webp") gönderin. Varsayılan, opak bir PNG'dir.

MAI Image 2.7 API şeffaf bir JPEG döndürebilir mi? Hayır. JPEG'in alfa kanalı yoktur, bu yüzden transparent için PNG veya WebP gerekir.

MAI Image 2.7 Flash şeffaf arka planları destekliyor mu? Evet. mai-image-2.7-flash üzerindeki lansman günü testimiz, güncel oranlarla 2.062 krediye tamamen şeffaf arka planlı 1024x1024 RGBA bir PNG döndürdü.

MAI Image 2.7 API'de şeffaf arka plan daha mı pahalı? Hayır. Aynı boyuttaki diğer tüm görseller gibi aynı metin, görsel girişi ve çıktı token'ı oranlarıyla ücretlendirilir.

MAI Image 2.6 şeffaf PNG üretebilir mi? Hayır. Şeffaflık MAI Image 2.7 ile geldi. Diğer alan değişiklikleri için MAI Image 2.7 API vs MAI Image 2.6 API yazısına bakın.

Share: