guides

MAI Image 2.7 API: czym jest MAI Image 2.7, ceny, limity i Flash

Poyo.ai Team
8 min read
Share:

MAI Image 2.7 API w PoYo

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.7MAI Image 2.7 Flash
ID modelu w PoYomai-image-2.7mai-image-2.7-flash
Endpoint do wysyłkiPOST https://api.poyo.ai/api/generate/submitTen sam
WynikOdpytywanie GET /api/generate/status/{task_id} lub callback_urlTen sam
Tryby wejściaTekst-na-obraz; edycja 1 obrazu; łączenie 2 do 5 obrazówTe same
Pola żądaniaprompt, image_urls, size, resolution, background, output_formatTe same
Premiera u Microsoftu17 listopada 202617 listopada 2026
DokumentacjaDokumentacja MAI Image 2.7 APIDokumentacja 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

PoleZasada w PoYo
promptWymagane, 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_urlsOpcjonalna 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.
size1:1 (domyślnie), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 albo własne WIDTHxHEIGHT
Własny rozmiarOba boki podzielne przez 16, każdy bok co najmniej 768, łącznie najwyżej 4,194,304 pikseli; używany dokładnie tak, jak podano
resolution1K (domyślnie, ok. 1 megapiksel, 1:1 to 1024x1024) lub 2K (ok. 4 megapiksele, 16:9 to 2720x1536)
backgroundopaque (domyślnie) lub transparent; przezroczystość wymaga png lub webp
output_formatpng (domyślnie), jpeg, webp
Obrazy na żądanie1

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ówMAI Image 2.7 w PoYoMAI Image 2.7 Flash w PoYo
Wejście tekstowe1,000 kredytów ($5.00)350 kredytów ($1.75)
Wejście obrazowe1,600 kredytów ($8.00)500 kredytów ($2.50)
Wyjście obrazowe6,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.

ŻądanieWynikKoszt według obecnych stawekCzas
mai-image-2.7, 16:9, 2K, png, kawiarnia w deszczową noc z neonem o treści "OPEN LATE"2720x153627.802 kredytu (ok. $0.139)Ok. 66 s
mai-image-2.7-flash, to samo żądanie2720x15368.1803 kredytu (ok. $0.041)Ok. 42 s
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, w pełni przezroczyste tło2.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

ŻądanieModel do wywołania
Finalne obrazy hero, precyzyjne edycje, plakaty i opakowania z dużą ilością tekstumai-image-2.7
Szkice, podglądy, miniatury, masowe zadania katalogowe i naklejkimai-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.

Share: