guides

MAI Image 2.7 API: MAI Image 2.7 là gì, giá, giới hạn và Flash

Poyo.ai Team
9 min read
Share:

MAI Image 2.7 API trên PoYo

MAI Image 2.7 API cho bạn dùng model hình ảnh mới nhất của Microsoft AI qua một endpoint REST duy nhất trên PoYo: mai-image-2.7 cho tài nguyên cuối cùng và mai-image-2.7-flash cho các tác vụ rẻ hơn, nhanh hơn. Cả hai nhận cùng một request body, có thể tạo ảnh từ prompt hoặc chỉnh sửa tối đa 5 ảnh tham chiếu, và có thể trả về file PNG hoặc WebP trong suốt. Trang này trình bày MAI Image 2.7 là gì, các giới hạn chính xác, giá token và những gì chúng tôi đo được trong ngày ra mắt.

MAI Image 2.7 là gì?

MAI Image 2.7 là model tạo và chỉnh sửa ảnh của Microsoft AI (MAI), ra mắt cùng MAI Image 2.7 Flash vào ngày 17 tháng 11 năm 2026. Theo model card của Microsoft, đây là model dựa trên diffusion với 20 tỷ tham số không tính embedding, được xây dựng cho cả text-to-image lẫn "precise, controllable image-to-image editing", và MAI Image 2.7 Flash là "an optimized version of MAI Image 2.7".

Microsoft cho biết model được "rebuilt from the ground up for multimodal editing workflows" và liệt kê xóa đối tượng, thay thế, đổi thuộc tính, inpainting, cập nhật chữ và dọn lỗi ảnh (như nhòe chuyển động) trong số các thao tác chỉnh sửa. Microsoft cũng cho biết MAI Image 2.7 đứng #1 trên bảng xếp hạng AA-Image-Editing v2.1 của Artificial Analysis tính đến ngày 16 tháng 11 năm 2026, với 1,215 Elo qua 5,478 lượt bình chọn.

Với tích hợp API, điều đó có nghĩa là có ba loại request đáng gửi tới model này:

  • Chỉnh sửa cần giữ nguyên phần còn lại của ảnh: đổi màu sản phẩm, thay một đối tượng, viết lại biển hiệu hoặc nhãn.
  • Ảnh có chữ bên trong: model card của Microsoft báo cáo "improved rendering of text within generated images, including labels, posters, packaging, and signage".
  • Tài nguyên cần kênh alpha thực sự: Microsoft cho biết cả hai model "support transparent backgrounds", và PoYo cung cấp tính năng này dưới dạng background: "transparent".

Tổng quan MAI Image 2.7 API

MAI Image 2.7MAI Image 2.7 Flash
Model ID trên PoYomai-image-2.7mai-image-2.7-flash
Endpoint gửiPOST https://api.poyo.ai/api/generate/submitGiống nhau
Kết quảPolling GET /api/generate/status/{task_id} hoặc dùng callback_urlGiống nhau
Chế độ đầu vàoText-to-image; chỉnh sửa 1 ảnh; kết hợp 2 đến 5 ảnhGiống nhau
Trường requestprompt, image_urls, size, resolution, background, output_formatGiống nhau
Microsoft phát hành17 tháng 11 năm 202617 tháng 11 năm 2026
Tài liệuTài liệu tham khảo MAI Image 2.7 APITài liệu tham khảo MAI Image 2.7 Flash (cùng schema)

Hai schema của PoYo chỉ khác nhau ở model ID, nên đổi tier chỉ cần thay một chuỗi. So sánh tier trình bày khi nào mỗi tier đáng dùng.

Giới hạn và các trường request

TrườngQuy tắc trên PoYo
promptBắt buộc, 1 đến 32,000 ký tự, phải có văn bản không phải khoảng trắng. Đặt chữ cần hiện chính xác trên ảnh trong dấu ngoặc kép.
image_urlsTùy chọn, mảng gồm 1 đến 5 URL HTTP(S) công khai, JPEG, PNG hoặc WebP. Một ảnh thì được chỉnh sửa, nhiều ảnh thì được kết hợp. Ảnh tham chiếu được dùng ở mức tối đa khoảng 1 megapixel.
size1:1 (mặc định), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, hoặc WIDTHxHEIGHT tùy chỉnh
Kích thước tùy chỉnhCả hai cạnh chia hết cho 16, mỗi cạnh ít nhất 768, tổng tối đa 4,194,304 pixel; được dùng đúng như đã cho
resolution1K (mặc định, khoảng 1 megapixel, 1:1 là 1024x1024) hoặc 2K (khoảng 4 megapixel, 16:9 là 2720x1536)
backgroundopaque (mặc định) hoặc transparent; transparent cần png hoặc webp
output_formatpng (mặc định), jpeg, webp
Số ảnh mỗi request1

Khi có image_urls mà không có size, đầu ra theo tỷ lệ khung hình của ảnh tham chiếu đầu tiên ở khoảng 1 megapixel. Mức trần 4,194,304 pixel khớp với model card của Microsoft, vốn đưa ra cùng "maximum total pixel count" và lưu ý rằng một cạnh bất kỳ có thể vượt 2048 miễn là tổng vẫn nằm trong giới hạn.

Giá MAI Image 2.7 API

PoYo tính phí cả hai model theo token, với mức giá trong bảng giá của chúng tôi. 1 credit = $0.005.

Mỗi 1 triệu tokenMAI Image 2.7 trên PoYoMAI Image 2.7 Flash trên PoYo
Đầu vào văn bản1,000 credit ($5.00)350 credit ($1.75)
Đầu vào hình ảnh1,600 credit ($8.00)500 credit ($2.50)
Đầu ra hình ảnh6,800 credit ($34.00)2,000 credit ($10.00)

Trên PoYo, token đầu ra tỷ lệ với số pixel: khoảng một token cho mỗi 1,024 pixel. Ảnh 1024x1024 khoảng 1,024 token đầu ra, tức khoảng 6.96 credit ($0.035) trên MAI Image 2.7 và 2.05 credit ($0.0102) trên Flash, cộng một khoản nhỏ cho token văn bản của prompt. Phân tích giá chi tiết tính toán cho mọi kích thước.

Những gì chúng tôi đo được trong ngày ra mắt

Đội ngũ PoYo chạy các request này trên API production của PoYo vào ngày 19 tháng 11 năm 2026. Thời gian tính từ lúc gửi đến khi có kết quả, theo góc nhìn của một client polling vài giây một lần, nên hãy xem là con số ước lượng.

RequestĐầu raChi phí theo giá hiện hànhThời gian
mai-image-2.7, 16:9, 2K, png, quán cà phê đêm mưa với biển neon ghi "OPEN LATE"2720x153627.802 credit (khoảng $0.139)Khoảng 66 giây
mai-image-2.7-flash, cùng request2720x15368.1803 credit (khoảng $0.041)Khoảng 42 giây
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, nền hoàn toàn trong suốt2.062 credit (khoảng $0.0103)Khoảng 42 giây

Trong cả hai lần chạy quán cà phê, biển hiệu ghi đúng "OPEN LATE" như trong prompt. Lần chạy trong suốt trả về kênh alpha thực sự, không phải nền trắng hay nền ô caro; hướng dẫn nền trong suốt trình bày đầy đủ request.

Request MAI Image 2.7 API đầu tiên của bạn

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

Phản hồi chứa data.task_id với trạng thái not_started. Polling endpoint trạng thái cho đến khi là finished rồi đọc ảnh từ data.files[0].file_url, hoặc truyền callback_url ở cấp trên cùng để nhận POST khi tác vụ kết thúc. Luôn kiểm tra trường code trong body: một số lỗi xác thực trả về HTTP 200 với code: 400. Hướng dẫn API có vòng lặp polling Python có giới hạn thời gian và JSON body cho mọi chế độ đầu vào.

MAI Image 2.7 có sẵn ở đâu

Microsoft cung cấp MAI Image 2.7 dưới dạng model được host, không phải trọng số có thể tải về. Model đang ở giai đoạn public preview trên Microsoft Foundry, nơi tài liệu của Microsoft liệt kê MAI-Image-2.7 và MAI-Image-2.7-Flash (phiên bản 2026-11-02) theo kiểu triển khai Global Standard, và bạn có thể dùng thử trong MAI Labs, nơi Microsoft mô tả là dành cho mục đích cá nhân, phi thương mại.

Trên PoYo, bạn gọi cả hai model bằng chính API key bạn dùng cho mọi model khác, không cần gói đăng ký Azure hay bước triển khai. Cấu trúc request của PoYo cũng khác Foundry: một endpoint JSON nhận image_urls cho chỉnh sửa (Foundry dùng một endpoint chỉnh sửa multipart riêng), và bạn chọn tỷ lệ khung hình cộng 1K/2K hoặc một kích thước tùy chỉnh thay vì chiều rộng và chiều cao thô.

Nên định tuyến request nào đi đâu

RequestModel nên gọi
Ảnh hero cuối cùng, chỉnh sửa chính xác, poster và bao bì nhiều chữmai-image-2.7
Bản nháp, xem trước, thumbnail, tác vụ catalog và sticker khối lượng lớnmai-image-2.7-flash
Prompt cần thông tin web mới nhất (sự kiện hiện tại, địa điểm có thật)mai-image-2.6 với enable_web_search, xem MAI Image 2.6

MAI Image 2.7 không nhận tùy chọn tìm kiếm web mà MAI Image 2.6 có. Mọi thứ khác trong request 2.6 đều dùng lại được; so sánh 2.7 và 2.6 liệt kê các thay đổi trường và diff di chuyển.

Câu hỏi thường gặp

Model ID của MAI Image 2.7 API là gì? Dùng mai-image-2.7 cho bản flagship và mai-image-2.7-flash cho Flash. mai-image-2-7 chỉ là slug trang của PoYo và bị từ chối khi dùng làm model ID.

MAI Image 2.7 API giá bao nhiêu? Trên PoYo, MAI Image 2.7 có giá $5.00 / $8.00 / $34.00 mỗi 1 triệu token đầu vào văn bản, đầu vào hình ảnh và đầu ra, còn Flash là $1.75 / $2.50 / $10.00. Một ảnh 1024x1024 khoảng $0.035 trên MAI Image 2.7 và khoảng $0.0102 trên Flash.

MAI Image 2.7 API có tạo ảnh mới được không, hay chỉ chỉnh sửa? Cả hai. Request chỉ có prompt sẽ tạo ảnh mới. Thêm 1 đến 5 URL vào image_urls biến cùng request đó thành chỉnh sửa hoặc kết hợp nhiều ảnh.

MAI Image 2.7 API có hỗ trợ nền trong suốt không? Có. Gửi "background": "transparent" cùng "output_format": "png" hoặc "webp". Bài thử Flash trong ngày ra mắt của chúng tôi trả về một PNG RGBA 1024x1024 với nền hoàn toàn trong suốt.

Ảnh lớn nhất MAI Image 2.7 API có thể trả về là bao nhiêu? 4,194,304 pixel, ví dụ 2048x2048 hoặc kích thước tùy chỉnh 3072x1344. Ở 2K, 16:9 trả về 2720x1536.

Một request MAI Image 2.7 API mất bao lâu? Trong bài thử ngày 19 tháng 11 năm 2026, ảnh 2K 16:9 mất khoảng 66 giây trên MAI Image 2.7 và khoảng 42 giây trên Flash. Hãy dùng polling có hạn chót hoặc callback_url thay vì giữ request mở.

Share: