
MAI Image 2.7 API daje dostęp do najnowszego modelu obrazów od Microsoft AI przez jeden endpoint REST w PoYo: mai-image-2.7 do finalnych materiałów i mai-image-2.7-flash do tańszych, szybszych zadań. Oba przyjmują to samo ciało żądania, generują obraz z promptu albo edytują do 5 obrazów referencyjnych i mogą zwracać przezroczyste pliki PNG lub WebP. Ta strona opisuje, czym jest MAI Image 2.7, dokładne limity, ceny tokenów i to, co zmierzyliśmy w dniu premiery.
Czym jest MAI Image 2.7?
MAI Image 2.7 to model do generowania i edycji obrazów od Microsoft AI (MAI), wydany razem z MAI Image 2.7 Flash 17 listopada 2026. Według karty modelu Microsoftu jest to model dyfuzyjny z 20 miliardami parametrów (bez embeddingów), zbudowany zarówno do tekst-na-obraz, jak i do „precyzyjnej, kontrolowanej edycji obraz-na-obraz”, a MAI Image 2.7 Flash to „zoptymalizowana wersja MAI Image 2.7”.
Microsoft podaje, że model został „przebudowany od podstaw z myślą o multimodalnych procesach edycji”, i wymienia wśród operacji edycyjnych usuwanie obiektów, ich zamianę, zmianę atrybutów, inpainting, aktualizację tekstu i usuwanie artefaktów (np. rozmycia ruchu). Microsoft twierdzi też, że MAI Image 2.7 zajął 1. miejsce w rankingu AA-Image-Editing v2.1 Artificial Analysis według stanu na 16 listopada 2026, z wynikiem 1,215 Elo z 5,478 głosów.
W integracji przez API przekłada się to na trzy rodzaje żądań, które warto tu kierować:
- Edycje, które mają zostawić resztę obrazu bez zmian: zmiana koloru produktu, podmieniony obiekt, przepisany szyld lub etykieta.
- Obrazy z tekstem w kadrze: karta modelu Microsoftu mówi o „lepszym renderowaniu tekstu w generowanych obrazach, w tym etykiet, plakatów, opakowań i szyldów”.
- Materiały, które potrzebują prawdziwego kanału alfa: Microsoft podaje, że oba modele „obsługują przezroczyste tła”, a PoYo udostępnia to jako
background: "transparent".
MAI Image 2.7 API w skrócie
| MAI Image 2.7 | MAI Image 2.7 Flash | |
|---|---|---|
| ID modelu w PoYo | mai-image-2.7 | mai-image-2.7-flash |
| Endpoint do wysyłki | POST https://api.poyo.ai/api/generate/submit | Ten sam |
| Wynik | Odpytywanie GET /api/generate/status/{task_id} lub callback_url | Ten sam |
| Tryby wejścia | Tekst-na-obraz; edycja 1 obrazu; łączenie 2 do 5 obrazów | Te same |
| Pola żądania | prompt, image_urls, size, resolution, background, output_format | Te same |
| Premiera u Microsoftu | 17 listopada 2026 | 17 listopada 2026 |
| Dokumentacja | Dokumentacja MAI Image 2.7 API | Dokumentacja MAI Image 2.7 Flash (ten sam schemat) |
Oba schematy w PoYo różnią się tylko ID modelu, więc zmiana wariantu to zmiana jednego ciągu znaków. Porównanie wariantów pokazuje, kiedy który się opłaca.
Limity i pola żądania
| Pole | Zasada w PoYo |
|---|---|
prompt | Wymagane, od 1 do 32,000 znaków, musi zawierać tekst inny niż białe znaki. Dokładny tekst do umieszczenia na obrazie podaj w cudzysłowie. |
image_urls | Opcjonalna tablica 1 do 5 publicznych adresów HTTP(S), JPEG, PNG lub WebP. Jeden obraz jest edytowany, kilka jest łączonych. Obrazy referencyjne są używane w rozdzielczości do ok. 1 megapiksela. |
size | 1:1 (domyślnie), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 albo własne WIDTHxHEIGHT |
| Własny rozmiar | Oba boki podzielne przez 16, każdy bok co najmniej 768, łącznie najwyżej 4,194,304 pikseli; używany dokładnie tak, jak podano |
resolution | 1K (domyślnie, ok. 1 megapiksel, 1:1 to 1024x1024) lub 2K (ok. 4 megapiksele, 16:9 to 2720x1536) |
background | opaque (domyślnie) lub transparent; przezroczystość wymaga png lub webp |
output_format | png (domyślnie), jpeg, webp |
| Obrazy na żądanie | 1 |
Przy image_urls i bez size wynik zachowuje proporcje pierwszego obrazu referencyjnego w rozdzielczości ok. 1 megapiksela. Limit 4,194,304 pikseli zgadza się z kartą modelu Microsoftu, która podaje tę samą „maksymalną łączną liczbę pikseli” i zaznacza, że każdy bok może przekroczyć 2048, o ile suma mieści się w limicie.
Cennik MAI Image 2.7 API
PoYo rozlicza oba modele za tokeny, według stawek z naszego cennika. 1 kredyt = $0.005.
| Za 1M tokenów | MAI Image 2.7 w PoYo | MAI Image 2.7 Flash w PoYo |
|---|---|---|
| Wejście tekstowe | 1,000 kredytów ($5.00) | 350 kredytów ($1.75) |
| Wejście obrazowe | 1,600 kredytów ($8.00) | 500 kredytów ($2.50) |
| Wyjście obrazowe | 6,800 kredytów ($34.00) | 2,000 kredytów ($10.00) |
W PoYo liczba tokenów wyjściowych zależy od liczby pikseli: ok. jeden token na 1,024 piksele. Obraz 1024x1024 to ok. 1,024 tokenów wyjściowych, czyli ok. 6.96 kredytu ($0.035) w MAI Image 2.7 i 2.05 kredytu ($0.0102) we Flash, plus niewielka opłata za tokeny tekstowe promptu. Szczegółowy cennik przelicza wszystkie rozmiary.
Co zmierzyliśmy w dniu premiery
Zespół PoYo uruchomił te żądania na produkcyjnym API PoYo 19 listopada 2026. Czasy liczone są od wysłania do wyniku z perspektywy klienta odpytującego co kilka sekund, więc traktuj je jako przybliżone.
| Żądanie | Wynik | Koszt według obecnych stawek | Czas |
|---|---|---|---|
mai-image-2.7, 16:9, 2K, png, kawiarnia w deszczową noc z neonem o treści "OPEN LATE" | 2720x1536 | 27.802 kredytu (ok. $0.139) | Ok. 66 s |
mai-image-2.7-flash, to samo żądanie | 2720x1536 | 8.1803 kredytu (ok. $0.041) | Ok. 42 s |
mai-image-2.7-flash, 1:1, 1K, background: transparent, png | 1024x1024 RGBA, w pełni przezroczyste tło | 2.062 kredytu (ok. $0.0103) | Ok. 42 s |
W obu przebiegach z kawiarnią neon brzmiał "OPEN LATE", dokładnie tak jak w prompcie. Przebieg z przezroczystością zwrócił prawdziwy kanał alfa, a nie białe tło ani szachownicę; poradnik o przezroczystym tle pokazuje pełne żądanie.
Twoje pierwsze żądanie do MAI Image 2.7 API
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",
"input": {
"prompt": "A university campus poster at dusk with the title \"Open Day 2026\", photorealistic, cinematic light",
"size": "16:9",
"resolution": "2K"
}
}'
Odpowiedź zawiera data.task_id ze statusem not_started. Odpytuj endpoint statusu, aż zwróci finished, i odczytaj obraz z data.files[0].file_url, albo przekaż na najwyższym poziomie callback_url, aby dostać POST po zakończeniu zadania. Zawsze sprawdzaj pole code w ciele odpowiedzi: niektóre błędy walidacji zwracają HTTP 200 z code: 400. Poradnik API zawiera ograniczoną czasowo pętlę odpytywania w Pythonie i ciało JSON dla każdego trybu wejścia.
Gdzie MAI Image 2.7 jest dostępny
Microsoft udostępnia MAI Image 2.7 jako model hostowany, a nie wagi do pobrania. Jest w publicznej wersji preview w Microsoft Foundry, gdzie dokumentacja Microsoftu wymienia MAI-Image-2.7 i MAI-Image-2.7-Flash (wersja 2026-11-02) we wdrożeniu Global Standard; można go też wypróbować w MAI Labs, które Microsoft opisuje jako przeznaczone do osobistego, niekomercyjnego użytku.
W PoYo oba modele wywołujesz tym samym kluczem API co każdy inny model, bez subskrypcji Azure i bez kroku wdrożenia. Format żądania w PoYo różni się też od Foundry: jeden endpoint JSON przyjmuje image_urls do edycji (Foundry używa osobnego endpointu multipart do edycji), a zamiast surowej szerokości i wysokości wybierasz proporcje plus 1K/2K albo własny rozmiar.
Które żądania kierować dokąd
| Żądanie | Model do wywołania |
|---|---|
| Finalne obrazy hero, precyzyjne edycje, plakaty i opakowania z dużą ilością tekstu | mai-image-2.7 |
| Szkice, podglądy, miniatury, masowe zadania katalogowe i naklejki | mai-image-2.7-flash |
| Prompty wymagające aktualnych faktów z sieci (bieżące wydarzenia, prawdziwe miejsca) | mai-image-2.6 z enable_web_search, zob. MAI Image 2.6 |
MAI Image 2.7 nie przyjmuje opcji wyszukiwania w sieci, którą ma MAI Image 2.6. Wszystko inne z żądania 2.6 przenosi się bez zmian; porównanie 2.7 z 2.6 wymienia zmiany pól i diff migracji.
Najczęściej zadawane pytania
Jakie jest ID modelu w MAI Image 2.7 API?
Użyj mai-image-2.7 dla flagowego modelu i mai-image-2.7-flash dla Flash. mai-image-2-7 to tylko slug strony w PoYo i jako ID modelu jest odrzucany.
Ile kosztuje MAI Image 2.7 API? W PoYo MAI Image 2.7 kosztuje $5.00 / $8.00 / $34.00 za 1M tokenów wejścia tekstowego, wejścia obrazowego i wyjścia, a Flash $1.75 / $2.50 / $10.00. Obraz 1024x1024 kosztuje ok. $0.035 w MAI Image 2.7 i ok. $0.0102 we Flash.
Czy MAI Image 2.7 API generuje nowe obrazy, czy tylko edytuje?
Jedno i drugie. Żądanie z samym prompt generuje nowy obraz. Dodanie 1 do 5 adresów w image_urls zamienia to samo żądanie w edycję lub kompozycję z wielu obrazów.
Czy MAI Image 2.7 API obsługuje przezroczyste tła?
Tak. Wyślij "background": "transparent" z "output_format": "png" lub "webp". Nasz test Flash z dnia premiery zwrócił PNG 1024x1024 RGBA z w pełni przezroczystym tłem.
Jaki jest największy obraz, jaki może zwrócić MAI Image 2.7 API?
4,194,304 pikseli, na przykład 2048x2048 lub własne 3072x1344. Przy 2K proporcje 16:9 dają 2720x1536.
Ile trwa żądanie do MAI Image 2.7 API?
W naszym teście z 19 listopada 2026 obraz 2K 16:9 zajął ok. 66 sekund w MAI Image 2.7 i ok. 42 sekundy we Flash. Używaj odpytywania z limitem czasu lub callback_url zamiast trzymać otwarte żądanie.