
MAI Image 2.7 API có thể trả về ảnh có kênh alpha thực sự, nên ảnh tách nền sản phẩm, logo, icon và sticker ra lò là đặt được ngay lên bất kỳ nền nào mà không cần bước tạo mask. Trên PoYo, tính năng này dùng hai trường, background và output_format, trên cả mai-image-2.7 lẫn mai-image-2.7-flash. Trong bài thử ngày ra mắt, một PNG trong suốt 1024x1024 trên Flash tính theo giá hiện hành là 2.062 credit, khoảng $0.0103. Hãy thử trên trang model MAI Image 2.7 trước khi đưa vào mã.
Microsoft nói gì về nền trong suốt
Bài ra mắt của Microsoft cho biết "both models support transparent backgrounds for ready-to-use product images", và nêu logo, icon và hình minh họa là các ứng dụng khác. Tài liệu Foundry của Microsoft liệt kê nền trong suốt là khả năng mà MAI-Image-2.7 bổ sung so với các model ảnh MAI trước đó, "for assets such as product imagery, logos, icons, and design elements that need to be placed over other content". MAI Image 2.6 không có tùy chọn này.
Hai trường
| Trường | Giá trị | Mặc định | Quy tắc |
|---|---|---|---|
background | opaque, transparent | opaque | transparent trả về ảnh có kênh alpha |
output_format | png, jpeg, webp | png | transparent yêu cầu png hoặc webp |
Vì mặc định là opaque và png, bạn phải gửi background một cách tường minh để có nền trong suốt. Có thể bỏ output_format nếu dùng PNG, nhưng gửi nó sẽ giúp ý định rõ ràng trong log. "background": "transparent" cùng "output_format": "jpeg" là không hợp lệ, vì JPEG không có kênh alpha; hãy xác thực tổ hợp này ở phía bạn để nó bị loại trước khi gửi.
Mọi trường khác hoạt động như thường: size (mặc định 1:1, mọi tỷ lệ preset, hoặc WIDTHxHEIGHT tùy chỉnh tối đa 4,194,304 pixel), resolution (1K hoặc 2K), và callback_url tùy chọn. Quy tắc đầy đủ của các trường có trong tài liệu tham khảo API.
Request body
PNG trong suốt với MAI Image 2.7 API
Một sticker vuông 1K trên Flash, với cùng cài đặt trường như lần chạy chúng tôi đã đo (prompt chỉ là ví dụ):
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 trong suốt
Ví dụ từ tài liệu của PoYo, trên bản 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 cũng mang được kênh alpha và thường cho file nhỏ hơn PNG, phù hợp cho trang web. PNG là lựa chọn an toàn hơn cho quy trình in ấn và các công cụ thiết kế vốn mặc định dùng PNG.
Cả hai request đều trả về task_id. Polling GET https://api.poyo.ai/api/generate/status/{task_id} cho đến khi status là finished, rồi tải data.files[0].file_url. Hướng dẫn MAI Image 2.7 API có vòng lặp polling đầy đủ.
Thực đo: một sticker trong suốt trong ngày ra mắt
Đội ngũ PoYo chạy bài này trên API production của PoYo vào ngày 19 tháng 11 năm 2026:
| Cài đặt | Giá trị |
|---|---|
| Model | mai-image-2.7-flash |
| Các trường | size: "1:1", resolution: "1K", background: "transparent", output_format: "png" |
| Đầu ra | PNG 1024x1024, RGBA |
| Nền | Alpha thực sự: hoàn toàn trong suốt quanh chủ thể |
| Chi phí theo giá hiện hành | 2.062 credit (khoảng $0.0103) |
| Thời gian | Khoảng 42 giây, từ lúc gửi đến khi có kết quả với polling vài giây một lần |
Ước tính suy ra: 1024x1024 là khoảng 1,024 token đầu ra ở mức 2,000 credit mỗi 1 triệu, tức 2.048 credit; phần còn lại 0.014 credit khớp với khoảng 40 token prompt ở mức 350 credit mỗi 1 triệu. Nói cách khác, ảnh trong suốt được tính phí như mọi ảnh khác cùng kích thước. Bảng giá không có phụ phí cho nền trong suốt.
Kiểm tra kênh alpha trong mã
Đừng tin vào phần mở rộng file: hãy xác nhận ảnh đã tải thực sự có pixel trong suốt trước khi đưa vào thư viện tài nguyên. Với 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
Kết quả có lo == 0 và một tỷ lệ đáng kể pixel hoàn toàn trong suốt nghĩa là ảnh tách nền dùng được. Một bức ảnh vẽ nền ô caro sẽ cho lo == 255, mọi pixel đều không trong suốt. Hãy chọn ngưỡng cho tài nguyên của riêng bạn: một hình minh họa kín khung sẽ có ít khoảng trống hơn một icon đặt ở giữa.
Viết prompt để tách nền gọn gàng
Model xử lý kênh alpha; prompt vẫn quyết định việc tách chủ thể dễ đến đâu.
- Nói rõ chủ thể đứng một mình. Ví dụ trong tài liệu PoYo kết thúc bằng "clean edges, no background". Ví dụ ảnh trong suốt trên Foundry của Microsoft dùng "full body, centered, no shadow".
- Tránh từ ngữ mô tả bối cảnh. "On a table", "in a studio" hay "with a shadow" yêu cầu những thứ nằm ngoài chủ thể.
- Yêu cầu viền cho sticker. Một viền trắng dày dễ nhìn trên cả nền sáng lẫn nền tối.
- Đặt chữ trong ngoặc kép. Nếu tài nguyên có chữ hoặc chữ trong logo, hãy đặt trong ngoặc kép, như tài liệu khuyến nghị cho chữ trên ảnh.
Chi phí tài nguyên trong suốt ở khối lượng lớn
Token đầu ra chỉ phụ thuộc vào số pixel, nên nền trong suốt có chi phí như đầu ra không trong suốt. Chi phí token đầu ra mỗi ảnh:
| Kích thước | MAI Image 2.7 | MAI Image 2.7 Flash |
|---|---|---|
1024x1024 (1:1, 1K) | 6.96 credit ($0.0348) | 2.05 credit ($0.0102) |
2048x2048 (1:1, 2K) | 27.85 credit ($0.1393) | 8.19 credit ($0.0410) |
Với 2.062 credit thực đo cho mỗi sticker Flash, 1,000 sticker tốn khoảng 2,062 credit, xấp xỉ $10.31. Dùng Flash cho bộ icon và ảnh tách nền catalog, và MAI Image 2.7 khi một tài nguyên đơn lẻ, như logo thương hiệu hay ảnh sản phẩm hero, phải đạt chất lượng tốt nhất có thể. Bài viết về giá và so sánh Flash với 2.7 đi sâu hơn.
Cài đặt cho các tác vụ tài nguyên trong suốt phổ biến
| Tác vụ | Model | size / resolution | output_format |
|---|---|---|---|
| Sticker chat hoặc ứng dụng số lượng lớn | mai-image-2.7-flash | 1:1, 1K | png hoặc webp |
| Icon và hình minh họa cho website | mai-image-2.7-flash | 1:1, 1K | webp |
| Ảnh tách nền sản phẩm thương mại điện tử | mai-image-2.7 | 1:1 hoặc 3:4, 2K | png |
| Logo thương hiệu cho in ấn và slide | mai-image-2.7 | 1:1, 2K | png |
| Thành phần banner rộng để đặt chồng lên ảnh hero | mai-image-2.7 | Tùy chỉnh, ví dụ 3072x1344 | webp |
Đây là điểm khởi đầu, không phải quy tắc: mỗi dòng chỉ dùng các trường có trong tài liệu, nên bạn có thể chuyển tác vụ giữa các tier hoặc kích thước mà không thay đổi gì khác trong request. Hãy chạy kiểm tra alpha trên lô đầu tiên của mỗi loại tác vụ mới.
Chỉnh sửa với kết quả trong suốt
Schema cũng cho phép dùng background: "transparent" cùng image_urls, ví dụ để biến một ảnh sản phẩm thành ảnh tách nền hoặc đổi phong cách một sticker sẵn có mà vẫn giữ kênh alpha. Chúng tôi chưa đo tổ hợp này, nên hãy thử trên vài ảnh của riêng bạn và chạy kiểm tra alpha ở trên trước khi dựa vào nó trong production.
Câu hỏi thường gặp
Làm sao để có nền trong suốt từ MAI Image 2.7 API?
Gửi "background": "transparent" và "output_format": "png" (hoặc "webp") bên trong input. Mặc định là PNG không trong suốt.
MAI Image 2.7 API có trả về JPEG trong suốt được không?
Không. JPEG không có kênh alpha, nên transparent yêu cầu PNG hoặc WebP.
MAI Image 2.7 Flash có hỗ trợ nền trong suốt không?
Có. Bài thử ngày ra mắt của chúng tôi trên mai-image-2.7-flash trả về một PNG RGBA 1024x1024 với nền hoàn toàn trong suốt, tính theo giá hiện hành là 2.062 credit.
Nền trong suốt có tốn hơn trong MAI Image 2.7 API không? Không. Nó được tính theo cùng mức giá token văn bản, đầu vào hình ảnh và đầu ra như mọi ảnh khác cùng kích thước.
MAI Image 2.6 có tạo được PNG trong suốt không? Không. Nền trong suốt là tính năng mới của MAI Image 2.7. Xem MAI Image 2.7 API vs MAI Image 2.6 API để biết các thay đổi trường khác.