guides

MAI Image 2.7 API: Apa Itu MAI Image 2.7, Harga, Batas, dan Flash

Poyo.ai Team
8 min read
Share:

MAI Image 2.7 API di PoYo

MAI Image 2.7 API memberi Anda akses ke model gambar terbaru Microsoft AI melalui satu endpoint REST di PoYo: mai-image-2.7 untuk aset final dan mai-image-2.7-flash untuk pekerjaan yang lebih murah dan cepat. Keduanya menerima body request yang sama, bisa membuat gambar dari prompt atau mengedit hingga 5 gambar referensi, dan bisa mengembalikan file PNG atau WebP transparan. Halaman ini membahas apa itu MAI Image 2.7, batas pastinya, harga token, dan hasil yang kami ukur pada hari peluncuran.

Apa itu MAI Image 2.7?

MAI Image 2.7 adalah model pembuatan dan pengeditan gambar dari Microsoft AI (MAI), dirilis bersama MAI Image 2.7 Flash pada 17 November 2026. Menurut model card Microsoft, ini adalah model berbasis difusi dengan 20 miliar parameter non-embedding, dibuat untuk text-to-image sekaligus "precise, controllable image-to-image editing", dan MAI Image 2.7 Flash adalah "an optimized version of MAI Image 2.7".

Microsoft menyebut model ini "rebuilt from the ground up for multimodal editing workflows" dan mencantumkan penghapusan objek, penggantian, perubahan atribut, inpainting, pembaruan teks, dan pembersihan artefak (seperti motion blur) sebagai aksi pengeditannya. Microsoft juga menyatakan MAI Image 2.7 menempati peringkat #1 di leaderboard AA-Image-Editing v2.1 milik Artificial Analysis per 16 November 2026, dengan 1,215 Elo dari 5,478 suara.

Untuk integrasi API, artinya ada tiga jenis request yang layak dikirim ke sini:

  • Edit yang tidak boleh mengubah bagian gambar lainnya: perubahan warna produk, objek yang diganti, papan nama atau label yang ditulis ulang.
  • Gambar dengan teks di dalamnya: model card Microsoft melaporkan "improved rendering of text within generated images, including labels, posters, packaging, and signage".
  • Aset yang membutuhkan alpha channel sungguhan: Microsoft menyatakan kedua model "support transparent backgrounds", dan PoYo menyediakannya sebagai background: "transparent".

Sekilas MAI Image 2.7 API

MAI Image 2.7MAI Image 2.7 Flash
ID model PoYomai-image-2.7mai-image-2.7-flash
Endpoint submitPOST https://api.poyo.ai/api/generate/submitSama
HasilPolling GET /api/generate/status/{task_id} atau gunakan callback_urlSama
Mode inputText-to-image; edit 1 gambar; gabungkan 2 sampai 5 gambarSama
Field requestprompt, image_urls, size, resolution, background, output_formatSama
Rilis Microsoft17 November 202617 November 2026
DokumentasiReferensi MAI Image 2.7 APIReferensi MAI Image 2.7 Flash (skema sama)

Kedua skema PoYo hanya berbeda pada ID model, jadi berpindah tier cukup dengan mengubah satu string. Perbandingan tier membahas kapan masing-masing lebih menguntungkan.

Batas dan field request

FieldAturan di PoYo
promptWajib, 1 sampai 32,000 karakter, harus berisi teks selain spasi. Tulis teks yang harus muncul di gambar dalam tanda kutip.
image_urlsOpsional, array berisi 1 sampai 5 URL HTTP(S) publik, JPEG, PNG atau WebP. Satu gambar diedit, beberapa gambar digabungkan. Gambar referensi dipakai hingga sekitar 1 megapiksel.
size1:1 (default), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, atau WIDTHxHEIGHT kustom
Ukuran kustomKedua sisi habis dibagi 16, tiap sisi minimal 768, total maksimal 4,194,304 piksel; dipakai persis seperti yang diberikan
resolution1K (default, sekitar 1 megapiksel, 1:1 adalah 1024x1024) atau 2K (sekitar 4 megapiksel, 16:9 adalah 2720x1536)
backgroundopaque (default) atau transparent; transparent membutuhkan png atau webp
output_formatpng (default), jpeg, webp
Gambar per request1

Dengan image_urls dan tanpa size, output mengikuti rasio aspek gambar referensi pertama pada sekitar 1 megapiksel. Batas 4,194,304 piksel sama dengan model card Microsoft, yang memberikan "maximum total pixel count" yang sama dan mencatat bahwa salah satu sisi boleh melebihi 2048 selama totalnya tetap di bawah batas itu.

Harga MAI Image 2.7 API

PoYo menagih kedua model berdasarkan token, dengan tarif di daftar harga kami. 1 kredit = $0.005.

Per 1 juta tokenMAI Image 2.7 di PoYoMAI Image 2.7 Flash di PoYo
Input teks1,000 kredit ($5.00)350 kredit ($1.75)
Input gambar1,600 kredit ($8.00)500 kredit ($2.50)
Output gambar6,800 kredit ($34.00)2,000 kredit ($10.00)

Di PoYo, token output mengikuti jumlah piksel: sekitar satu token per 1,024 piksel. Gambar 1024x1024 sekitar 1,024 token output, yaitu sekitar 6.96 kredit ($0.035) di MAI Image 2.7 dan 2.05 kredit ($0.0102) di Flash, ditambah biaya kecil untuk token teks prompt. Rincian harga menghitung setiap ukuran.

Yang kami ukur pada hari peluncuran

Tim PoYo menjalankan ini di API produksi PoYo pada 19 November 2026. Waktu adalah dari submit sampai hasil, seperti yang terlihat oleh klien yang melakukan polling setiap beberapa detik, jadi anggap sebagai perkiraan.

RequestOutputBiaya pada tarif saat iniWaktu
mai-image-2.7, 16:9, 2K, png, kafe di malam hujan dengan papan neon bertuliskan "OPEN LATE"2720x153627.802 kredit (sekitar $0.139)Sekitar 66 dtk
mai-image-2.7-flash, request yang sama2720x15368.1803 kredit (sekitar $0.041)Sekitar 42 dtk
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, latar belakang sepenuhnya transparan2.062 kredit (sekitar $0.0103)Sekitar 42 dtk

Pada kedua run kafe, papan nama terbaca "OPEN LATE" persis seperti yang ditulis di prompt. Run transparan mengembalikan alpha channel sungguhan, bukan latar putih atau papan catur; panduan latar belakang transparan menampilkan request lengkapnya.

Request MAI Image 2.7 API pertama Anda

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

Respons berisi data.task_id dengan status not_started. Lakukan polling ke endpoint status sampai finished lalu baca gambar dari data.files[0].file_url, atau kirim callback_url di level atas untuk menerima POST saat task selesai. Selalu periksa field code di body: beberapa error validasi dikembalikan dengan HTTP 200 dan code: 400. Panduan API berisi loop polling Python dengan batas waktu dan body JSON untuk setiap mode input.

Di mana MAI Image 2.7 tersedia

Microsoft menawarkan MAI Image 2.7 sebagai model hosted, bukan bobot yang bisa diunduh. Model ini dalam public preview di Microsoft Foundry, tempat dokumentasi Microsoft mencantumkan MAI-Image-2.7 dan MAI-Image-2.7-Flash (versi 2026-11-02) dengan deployment Global Standard, dan Anda bisa mencobanya di MAI Labs, yang menurut Microsoft ditujukan untuk penggunaan pribadi dan non-komersial.

Di PoYo, Anda memanggil kedua model dengan API key yang sama yang Anda pakai untuk model lain, tanpa langganan Azure atau langkah deployment. Bentuk request PoYo juga berbeda dari Foundry: satu endpoint JSON menerima image_urls untuk edit (Foundry memakai endpoint edit multipart terpisah), dan Anda memilih rasio aspek plus 1K/2K atau ukuran kustom, bukan lebar dan tinggi mentah.

Request mana diarahkan ke mana

RequestModel yang dipanggil
Gambar hero final, edit presisi, poster dan kemasan dengan banyak teksmai-image-2.7
Draf, pratinjau, thumbnail, pekerjaan katalog dan stiker volume tinggimai-image-2.7-flash
Prompt yang butuh fakta web terkini (peristiwa terbaru, tempat nyata)mai-image-2.6 dengan enable_web_search, lihat MAI Image 2.6

MAI Image 2.7 tidak menerima opsi pencarian web yang dimiliki MAI Image 2.6. Semua hal lain dalam request 2.6 tetap berlaku; perbandingan 2.7 vs 2.6 mencantumkan perubahan field dan diff migrasinya.

Pertanyaan yang sering diajukan

Apa ID model MAI Image 2.7 API? Gunakan mai-image-2.7 untuk flagship dan mai-image-2.7-flash untuk Flash. mai-image-2-7 hanyalah slug halaman PoYo dan ditolak sebagai ID model.

Berapa biaya MAI Image 2.7 API? Di PoYo, MAI Image 2.7 berharga $5.00 / $8.00 / $34.00 per 1 juta token input teks, input gambar, dan output, sedangkan Flash $1.75 / $2.50 / $10.00. Gambar 1024x1024 sekitar $0.035 di MAI Image 2.7 dan sekitar $0.0102 di Flash.

Apakah MAI Image 2.7 API bisa membuat gambar baru, atau hanya mengedit? Keduanya. Request yang hanya berisi prompt membuat gambar baru. Menambahkan 1 sampai 5 URL di image_urls mengubah request yang sama menjadi edit atau komposisi multi-gambar.

Apakah MAI Image 2.7 API mendukung latar belakang transparan? Ya. Kirim "background": "transparent" bersama "output_format": "png" atau "webp". Uji Flash kami pada hari peluncuran mengembalikan PNG RGBA 1024x1024 dengan latar belakang sepenuhnya transparan.

Berapa ukuran gambar terbesar yang bisa dikembalikan MAI Image 2.7 API? 4,194,304 piksel, misalnya 2048x2048 atau 3072x1344 kustom. Pada 2K, 16:9 menghasilkan 2720x1536.

Berapa lama sebuah request MAI Image 2.7 API? Dalam uji kami pada 19 November 2026, gambar 2K 16:9 butuh sekitar 66 detik di MAI Image 2.7 dan sekitar 42 detik di Flash. Gunakan polling dengan tenggat waktu atau callback_url daripada menahan request tetap terbuka.

Share: