how-tos

MAI Image 2.7 API i przezroczyste tło: materiały PNG i WebP

Poyo.ai Team
7 min read
Share:

Przezroczyste materiały PNG i WebP z MAI Image 2.7 API

MAI Image 2.7 API potrafi zwracać obrazy z prawdziwym kanałem alfa, więc wycinki produktów, logotypy, ikony i naklejki są od razu gotowe do umieszczenia na dowolnym tle, bez maskowania. W PoYo wymaga to dwóch pól, background i output_format, w mai-image-2.7 lub mai-image-2.7-flash. W naszym teście z dnia premiery przezroczysty PNG 1024x1024 we Flash według obecnych stawek wychodzi 2.062 kredytu, ok. $0.0103. Wypróbuj to na stronie modelu MAI Image 2.7, zanim podłączysz to w kodzie.

Co Microsoft mówi o przezroczystości

Wpis premierowy Microsoftu mówi, że „oba modele obsługują przezroczyste tła dla gotowych do użycia zdjęć produktów”, i wymienia logotypy, ikony oraz ilustracje jako kolejne zastosowania. Dokumentacja Foundry wymienia przezroczyste tło jako funkcję, którą MAI-Image-2.7 dodaje względem wcześniejszych modeli obrazów MAI, „dla materiałów takich jak zdjęcia produktów, logotypy, ikony i elementy graficzne, które trzeba umieścić na innych treściach”. MAI Image 2.6 nie ma takiej opcji.

Dwa pola

PoleWartościDomyślnieZasada
backgroundopaque, transparentopaquetransparent zwraca obraz z kanałem alfa
output_formatpng, jpeg, webppngtransparent wymaga png lub webp

Ponieważ wartości domyślne to opaque i png, aby uzyskać przezroczystość, musisz jawnie wysłać background. output_format można pominąć dla PNG, ale jego wysłanie czyni intencję oczywistą w logach. "background": "transparent" z "output_format": "jpeg" jest niepoprawne, bo JPEG nie ma kanału alfa; waliduj tę kombinację po swojej stronie, aby odpadała przed wysłaniem.

Pozostałe pola działają jak zwykle: size (domyślnie 1:1, dowolne predefiniowane proporcje lub własne WIDTHxHEIGHT do 4,194,304 pikseli), resolution (1K lub 2K) i opcjonalny callback_url. Pełne zasady pól są w dokumentacji API.

Ciała żądań

Przezroczysty PNG w MAI Image 2.7 API

Kwadratowa naklejka 1K we Flash, z tymi samymi ustawieniami pól co w naszym zmierzonym przebiegu (prompt jest przykładowy):

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"
    }
  }'

Przezroczyste logo WebP

Przykład z dokumentacji PoYo, w modelu flagowym:

{
  "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 także przenosi kanał alfa i zwykle daje mniejsze pliki niż PNG, co pasuje do stron internetowych. PNG to bezpieczniejszy wybór dla procesów druku i narzędzi graficznych, które go oczekują.

Oba żądania zwracają task_id. Odpytuj GET https://api.poyo.ai/api/generate/status/{task_id}, aż status będzie finished, a potem pobierz data.files[0].file_url. Poradnik MAI Image 2.7 API zawiera kompletną pętlę odpytywania.

Pomiar: przezroczysta naklejka w dniu premiery

Zespół PoYo uruchomił to na produkcyjnym API PoYo 19 listopada 2026:

UstawienieWartość
Modelmai-image-2.7-flash
Polasize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
WynikPNG 1024x1024, RGBA
TłoPrawdziwy kanał alfa: pełna przezroczystość wokół obiektu
Koszt według obecnych stawek2.062 kredytu (ok. $0.0103)
CzasOk. 42 s, od wysłania do wyniku przy odpytywaniu co kilka sekund

Szacunek pochodny: 1024x1024 to ok. 1,024 tokeny wyjściowe po 2,000 kredytów za 1M, czyli 2.048 kredytu; pozostałe 0.014 kredytu odpowiada ok. 40 tokenom promptu po 350 kredytów za 1M. Innymi słowy, przezroczysty obraz został rozliczony jak każdy inny obraz tego rozmiaru. Cennik nie przewiduje dopłaty za przezroczystość.

Sprawdź kanał alfa w kodzie

Nie ufaj rozszerzeniu pliku: zanim obraz trafi do biblioteki materiałów, potwierdź, że pobrany plik rzeczywiście ma przezroczyste piksele. Z Pillow:

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

Wynik z lo == 0 i znaczącym udziałem w pełni przezroczystych pikseli oznacza użyteczny wycinek. Obraz przedstawiający szachownicę dałby lo == 255, czyli każdy piksel nieprzezroczysty. Dobierz próg do własnych materiałów: ilustracja wypełniająca cały kadr będzie miała mniej pustej przestrzeni niż wyśrodkowana ikona.

Prompty do czystych wycinków

Model obsługuje kanał alfa; prompt nadal decyduje o tym, jak łatwo wyodrębnić obiekt.

  • Napisz, że obiekt jest sam. Przykład z dokumentacji PoYo kończy się na „clean edges, no background”. Przykład Microsoftu z Foundry dla przezroczystego obrazu używa „full body, centered, no shadow”.
  • Unikaj słów opisujących scenę. „On a table”, „in a studio” czy „with a shadow” proszą o elementy spoza obiektu.
  • Przy naklejkach poproś o obrys. Gruba biała krawędź dobrze wygląda zarówno na jasnym, jak i ciemnym tle.
  • Każdy tekst bierz w cudzysłów. Jeśli materiał zawiera słowo lub tekst logo, umieść go w cudzysłowie, tak jak dokumentacja zaleca dla tekstu na obrazie.

Koszt przezroczystych materiałów w dużej skali

Tokeny wyjściowe zależą tylko od liczby pikseli, więc przezroczystość kosztuje tyle samo co nieprzezroczysty wynik. Koszt tokenów wyjściowych na obraz:

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

Przy zmierzonych 2.062 kredytu za naklejkę we Flash 1,000 naklejek to ok. 2,062 kredyty, mniej więcej $10.31. Używaj Flash do zestawów ikon i wycinków katalogowych, a MAI Image 2.7 wtedy, gdy pojedynczy materiał, np. logo marki czy główne zdjęcie produktu, musi być możliwie najlepszy. Artykuł o cenach i porównanie Flash z 2.7 omawiają to dokładniej.

Ustawienia dla typowych zadań z przezroczystymi materiałami

ZadanieModelsize / resolutionoutput_format
Masowe naklejki do czatu lub aplikacjimai-image-2.7-flash1:1, 1Kpng lub webp
Ikony i ilustracje na strony WWWmai-image-2.7-flash1:1, 1Kwebp
Wycinki produktów do e-commercemai-image-2.71:1 lub 3:4, 2Kpng
Logo marki do druku i prezentacjimai-image-2.71:1, 2Kpng
Szeroki element banera nakładany na obraz heromai-image-2.7Własny, np. 3072x1344webp

To punkty wyjścia, nie reguły: każdy wiersz używa wyłącznie udokumentowanych pól, więc możesz przenieść zadanie między wariantami lub rozmiarami bez zmiany czegokolwiek innego w żądaniu. Uruchom sprawdzanie kanału alfa na pierwszej partii każdego nowego typu zadania.

Edycja z przezroczystym wynikiem

Schemat pozwala też łączyć background: "transparent" z image_urls, na przykład by zamienić zdjęcie produktu w wycinek albo zmienić styl istniejącej naklejki z zachowaniem kanału alfa. Tej kombinacji jeszcze nie mierzyliśmy, więc przetestuj ją na kilku własnych obrazach i uruchom powyższe sprawdzanie kanału alfa, zanim zaczniesz na niej polegać na produkcji.

Najczęściej zadawane pytania

Jak uzyskać przezroczyste tło z MAI Image 2.7 API? Wyślij "background": "transparent" i "output_format": "png" (lub "webp") w input. Domyślnie zwracany jest nieprzezroczysty PNG.

Czy MAI Image 2.7 API może zwrócić przezroczysty JPEG? Nie. JPEG nie ma kanału alfa, więc transparent wymaga PNG lub WebP.

Czy MAI Image 2.7 Flash obsługuje przezroczyste tła? Tak. Nasz test z dnia premiery w mai-image-2.7-flash zwrócił PNG 1024x1024 RGBA z w pełni przezroczystym tłem za 2.062 kredytu według obecnych stawek.

Czy przezroczyste tło kosztuje więcej w MAI Image 2.7 API? Nie. Jest rozliczane według tych samych stawek za tekst, wejście obrazowe i tokeny wyjściowe co każdy inny obraz tego samego rozmiaru.

Czy MAI Image 2.6 tworzy przezroczyste PNG? Nie. Przezroczystość jest nowością w MAI Image 2.7. Pozostałe zmiany pól opisuje MAI Image 2.7 API vs MAI Image 2.6 API.

Share: