how-tos

Latar Belakang Transparan MAI Image 2.7 API: Aset PNG dan WebP

Poyo.ai Team
7 min read
Share:

Aset PNG dan WebP transparan dari MAI Image 2.7 API

MAI Image 2.7 API bisa mengembalikan gambar dengan alpha channel sungguhan, sehingga potongan produk, logo, ikon, dan stiker siap ditempatkan di latar apa pun tanpa langkah masking. Di PoYo, fitur ini memakai dua field, background dan output_format, baik di mai-image-2.7 maupun mai-image-2.7-flash. Dalam uji hari peluncuran kami, PNG transparan 1024x1024 di Flash berbiaya 2.062 kredit pada tarif saat ini, sekitar $0.0103. Coba dulu di halaman model MAI Image 2.7 sebelum menghubungkannya ke kode.

Apa kata Microsoft tentang transparansi

Artikel peluncuran Microsoft menyebut "both models support transparent backgrounds for ready-to-use product images", dan menyebut logo, ikon, dan ilustrasi sebagai kegunaan lainnya. Dokumentasi Foundry Microsoft mencantumkan latar belakang transparan sebagai kemampuan yang ditambahkan MAI-Image-2.7 dibanding model gambar MAI sebelumnya, "for assets such as product imagery, logos, icons, and design elements that need to be placed over other content". MAI Image 2.6 tidak memiliki opsi tersebut.

Dua field

FieldNilaiDefaultAturan
backgroundopaque, transparentopaquetransparent mengembalikan gambar dengan alpha channel
output_formatpng, jpeg, webppngtransparent membutuhkan png atau webp

Karena default-nya opaque dan png, Anda harus mengirim background secara eksplisit untuk mendapatkan transparansi. output_format boleh dihilangkan untuk PNG, tetapi mengirimkannya membuat maksud Anda jelas di log. "background": "transparent" dengan "output_format": "jpeg" tidak valid, karena JPEG tidak punya alpha channel; validasi kombinasi itu di sisi Anda agar gagal sebelum submit.

Semua field lain berperilaku seperti biasa: size (1:1 secara default, rasio preset apa pun, atau WIDTHxHEIGHT kustom hingga 4,194,304 piksel), resolution (1K atau 2K), dan callback_url opsional. Aturan field lengkap ada di referensi API.

Body request

PNG transparan dengan MAI Image 2.7 API

Stiker persegi 1K di Flash, dengan pengaturan field yang sama seperti run yang kami ukur (prompt-nya hanya contoh):

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

Logo WebP transparan

Contoh dari dokumentasi PoYo, di flagship:

{
  "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 juga membawa alpha dan biasanya menghasilkan file lebih kecil daripada PNG, cocok untuk halaman web. PNG adalah pilihan yang lebih aman untuk alur kerja cetak dan alat desain yang mengharapkannya.

Kedua request mengembalikan task_id. Lakukan polling GET https://api.poyo.ai/api/generate/status/{task_id} sampai status bernilai finished, lalu unduh data.files[0].file_url. Panduan MAI Image 2.7 API berisi loop polling lengkap.

Terukur: stiker transparan pada hari peluncuran

Tim PoYo menjalankan ini di API produksi PoYo pada 19 November 2026:

PengaturanNilai
Modelmai-image-2.7-flash
Fieldsize: "1:1", resolution: "1K", background: "transparent", output_format: "png"
OutputPNG 1024x1024, RGBA
Latar belakangAlpha sungguhan: sepenuhnya transparan di sekitar subjek
Biaya pada tarif saat ini2.062 kredit (sekitar $0.0103)
WaktuSekitar 42 dtk, dari submit sampai hasil dengan polling setiap beberapa detik

Estimasi turunan: 1024x1024 sekitar 1,024 token output pada 2,000 kredit per 1 juta, yaitu 2.048 kredit; sisa 0.014 kredit cocok dengan sekitar 40 token prompt pada 350 kredit per 1 juta. Dengan kata lain, gambar transparan ditagih seperti gambar lain dengan ukuran yang sama. Daftar harga tidak memiliki biaya tambahan untuk transparansi.

Periksa alpha channel di kode

Jangan percaya ekstensi file: pastikan gambar yang diunduh benar-benar memiliki piksel transparan sebelum masuk ke pustaka aset Anda. Dengan 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

Hasil dengan lo == 0 dan porsi piksel yang sepenuhnya transparan yang cukup berarti berarti potongan yang bisa dipakai. Gambar berisi pola papan catur akan menunjukkan lo == 255, semua piksel opaque. Tentukan ambang batas untuk aset Anda sendiri: ilustrasi satu bingkai penuh akan punya ruang kosong lebih sedikit daripada ikon yang diletakkan di tengah.

Model menangani alpha channel; prompt tetap menentukan seberapa mudah subjek dipisahkan.

  • Sebutkan bahwa subjek berdiri sendiri. Contoh di dokumentasi PoYo diakhiri dengan "clean edges, no background". Contoh Foundry Microsoft untuk gambar transparan memakai "full body, centered, no shadow".
  • Hindari kata-kata adegan. "On a table", "in a studio" atau "with a shadow" meminta hal-hal yang berada di luar subjek.
  • Minta outline untuk stiker. Bingkai putih tebal terlihat baik di latar terang maupun gelap.
  • Beri tanda kutip pada teks. Jika aset berisi kata atau teks logo, tulis dalam tanda kutip, seperti yang direkomendasikan dokumentasi untuk teks di gambar.

Biaya aset transparan dalam volume besar

Token output hanya bergantung pada jumlah piksel, jadi transparansi berbiaya sama dengan output opaque. Biaya token output per gambar:

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

Dengan 2.062 kredit terukur per stiker Flash, 1,000 stiker berjumlah sekitar 2,062 kredit, kira-kira $10.31. Gunakan Flash untuk set ikon dan potongan katalog, dan MAI Image 2.7 ketika satu aset, seperti logo merek atau foto produk hero, harus sebaik mungkin. Artikel harga dan perbandingan Flash vs 2.7 membahasnya lebih dalam.

Pengaturan untuk pekerjaan aset transparan yang umum

PekerjaanModelsize / resolutionoutput_format
Stiker chat atau aplikasi dalam jumlah besarmai-image-2.7-flash1:1, 1Kpng atau webp
Ikon dan ilustrasi situs webmai-image-2.7-flash1:1, 1Kwebp
Potongan produk e-commercemai-image-2.71:1 atau 3:4, 2Kpng
Logo merek untuk cetak dan slidemai-image-2.71:1, 2Kpng
Elemen banner lebar untuk ditumpuk di atas heromai-image-2.7Kustom, mis. 3072x1344webp

Ini titik awal, bukan aturan: setiap baris hanya memakai field yang terdokumentasi, sehingga Anda bisa memindahkan pekerjaan antar tier atau ukuran tanpa mengubah apa pun di request. Jalankan cek alpha pada batch pertama untuk setiap jenis pekerjaan baru.

Mengedit dengan hasil transparan

Skema juga mengizinkan background: "transparent" bersama image_urls, misalnya untuk mengubah foto produk menjadi potongan atau mengubah gaya stiker yang ada sambil mempertahankan alpha channel. Kami belum mengukur kombinasi itu, jadi uji pada beberapa gambar Anda sendiri dan jalankan cek alpha di atas sebelum mengandalkannya di produksi.

Pertanyaan yang sering diajukan

Bagaimana cara mendapatkan latar belakang transparan dari MAI Image 2.7 API? Kirim "background": "transparent" dan "output_format": "png" (atau "webp") di dalam input. Default-nya adalah PNG opaque.

Bisakah MAI Image 2.7 API mengembalikan JPEG transparan? Tidak. JPEG tidak punya alpha channel, jadi transparent membutuhkan PNG atau WebP.

Apakah MAI Image 2.7 Flash mendukung latar belakang transparan? Ya. Uji hari peluncuran kami di mai-image-2.7-flash mengembalikan PNG RGBA 1024x1024 dengan latar belakang sepenuhnya transparan seharga 2.062 kredit pada tarif saat ini.

Apakah latar belakang transparan lebih mahal di MAI Image 2.7 API? Tidak. Ditagih dengan tarif token teks, input gambar, dan output yang sama seperti gambar lain berukuran sama.

Bisakah MAI Image 2.6 membuat PNG transparan? Tidak. Transparansi adalah fitur baru di MAI Image 2.7. Lihat MAI Image 2.7 API vs MAI Image 2.6 API untuk perubahan field lainnya.

Share: