guides

MAI Image 2.7 API: MAI Image 2.7이란? 가격, 제한, Flash 정리

Poyo.ai Team
6 min read
Share:

PoYo의 MAI Image 2.7 API

MAI Image 2.7 API를 사용하면 Microsoft AI의 최신 이미지 모델을 PoYo의 REST 엔드포인트 하나로 호출할 수 있습니다. 최종 결과물에는 mai-image-2.7, 더 저렴하고 빠른 작업에는 mai-image-2.7-flash를 사용합니다. 두 모델은 같은 요청 본문을 받으며, 프롬프트로 생성하거나 최대 5장의 참조 이미지를 편집할 수 있고, 투명 PNG 또는 WebP 파일을 반환할 수 있습니다. 이 글에서는 MAI Image 2.7이 무엇인지, 정확한 제한, 토큰 가격, 그리고 출시일에 측정한 결과를 다룹니다.

MAI Image 2.7이란?

MAI Image 2.7은 Microsoft AI(MAI)의 이미지 생성 및 편집 모델로, 2026년 11월 17일 MAI Image 2.7 Flash와 함께 출시되었습니다. Microsoft의 모델 카드에 따르면 비임베딩 파라미터 200억 개의 확산(diffusion) 기반 모델로, 텍스트-이미지 생성과 "precise, controllable image-to-image editing" 모두를 위해 만들어졌으며, MAI Image 2.7 Flash는 "an optimized version of MAI Image 2.7"입니다.

Microsoft는 이 모델이 "rebuilt from the ground up for multimodal editing workflows"되었다고 밝히며, 편집 작업으로 객체 제거, 교체, 속성 변경, 인페인팅, 텍스트 수정, 아티팩트 정리(모션 블러 등)를 꼽습니다. 또한 Microsoft는 MAI Image 2.7이 2026년 11월 16일 기준 Artificial Analysis의 AA-Image-Editing v2.1 리더보드에서 5,478표, 1,215 Elo로 1위를 차지했다고 밝혔습니다.

API 연동 관점에서 이 모델에 보낼 가치가 있는 요청은 세 가지입니다.

  • 이미지의 나머지 부분은 그대로 두어야 하는 편집: 제품 색상 변경, 객체 교체, 간판이나 라벨 문구 수정.
  • 이미지 안에 텍스트가 들어가는 이미지: Microsoft의 모델 카드는 "improved rendering of text within generated images, including labels, posters, packaging, and signage"를 보고합니다.
  • 실제 알파 채널이 필요한 에셋: Microsoft는 두 모델 모두 "support transparent backgrounds"라고 밝혔으며, PoYo는 이를 background: "transparent"로 제공합니다.

MAI Image 2.7 API 한눈에 보기

MAI Image 2.7MAI Image 2.7 Flash
PoYo 모델 IDmai-image-2.7mai-image-2.7-flash
제출 엔드포인트POST https://api.poyo.ai/api/generate/submit동일
결과GET /api/generate/status/{task_id} 폴링 또는 callback_url 사용동일
입력 모드텍스트-이미지, 이미지 1장 편집, 2~5장 합성동일
요청 필드prompt, image_urls, size, resolution, background, output_format동일
Microsoft 출시2026년 11월 17일2026년 11월 17일
문서MAI Image 2.7 API 레퍼런스MAI Image 2.7 Flash 레퍼런스(스키마 동일)

두 PoYo 스키마는 모델 ID만 다르므로 티어 전환은 문자열 하나만 바꾸면 됩니다. 각 티어가 언제 유리한지는 티어 비교에서 다룹니다.

제한 및 요청 필드

필드PoYo 규칙
prompt필수, 1~32,000자, 공백이 아닌 텍스트 포함. 이미지에 들어갈 정확한 문구는 따옴표로 감쌈.
image_urls선택, 공개 HTTP(S) URL 1~5개의 배열, JPEG·PNG·WebP. 1장이면 편집, 여러 장이면 합성. 참조 이미지는 최대 약 1메가픽셀로 사용됨.
size1:1(기본값), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 또는 사용자 지정 WIDTHxHEIGHT
사용자 지정 크기양변이 16으로 나누어떨어지고, 각 변 768 이상, 총 4,194,304픽셀 이하. 지정한 그대로 사용됨
resolution1K(기본값, 약 1메가픽셀, 1:1은 1024x1024) 또는 2K(약 4메가픽셀, 16:9는 2720x1536)
backgroundopaque(기본값) 또는 transparent. transparent는 png 또는 webp 필요
output_formatpng(기본값), jpeg, webp
요청당 이미지 수1

image_urls가 있고 size가 없으면, 출력은 첫 번째 참조 이미지의 종횡비를 따르며 약 1메가픽셀입니다. 4,194,304픽셀 상한은 Microsoft의 모델 카드와 일치하며, 모델 카드는 같은 "maximum total pixel count"를 제시하고 합계가 그 안에 있으면 어느 한 변이 2048을 넘어도 된다고 설명합니다.

MAI Image 2.7 API 가격

PoYo는 두 모델 모두 당사 가격표의 요율로 토큰 단위 과금합니다. 1크레딧 = $0.005입니다.

100만 토큰당PoYo의 MAI Image 2.7PoYo의 MAI Image 2.7 Flash
텍스트 입력1,000크레딧($5.00)350크레딧($1.75)
이미지 입력1,600크레딧($8.00)500크레딧($2.50)
이미지 출력6,800크레딧($34.00)2,000크레딧($10.00)

PoYo에서 출력 토큰은 픽셀 수에 비례하며, 약 1,024픽셀당 1토큰입니다. 1024x1024 이미지는 약 1,024 출력 토큰으로, MAI Image 2.7에서 약 6.96크레딧($0.035), **Flash에서 약 2.05크레딧($0.0102)**이며, 여기에 프롬프트 텍스트 토큰에 대한 소액이 더해집니다. 모든 크기에 대한 계산은 가격 상세 분석에 있습니다.

출시일에 측정한 결과

PoYo 팀이 2026년 11월 19일 PoYo 프로덕션 API에서 실행했습니다. 시간은 몇 초마다 폴링하는 클라이언트 기준 제출부터 결과까지이므로 대략적인 값으로 보시기 바랍니다.

요청출력현재 요율 기준 비용시간
mai-image-2.7, 16:9, 2K, png, "OPEN LATE"라고 적힌 네온사인이 있는 비 오는 밤의 카페2720x153627.802크레딧(약 $0.139)약 66초
mai-image-2.7-flash, 동일 요청2720x15368.1803크레딧(약 $0.041)약 42초
mai-image-2.7-flash, 1:1, 1K, background: transparent, png1024x1024 RGBA, 완전히 투명한 배경2.062크레딧(약 $0.0103)약 42초

두 카페 실행 모두 간판이 프롬프트에 적힌 그대로 정확히 "OPEN LATE"로 표시되었습니다. 투명 실행은 흰색이나 체커보드 배경이 아닌 실제 알파 채널을 반환했습니다. 전체 요청은 투명 배경 가이드에 있습니다.

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

응답에는 data.task_id와 상태 not_started가 담겨 있습니다. 상태 엔드포인트를 finished가 될 때까지 폴링한 뒤 data.files[0].file_url에서 이미지를 읽거나, 최상위 callback_url을 전달해 작업 종료 시 POST를 받을 수 있습니다. 본문의 code 필드는 항상 확인하세요. 일부 검증 오류는 HTTP 200과 함께 code: 400을 반환합니다. API 가이드에는 제한 시간이 있는 Python 폴링 루프와 모든 입력 모드의 JSON 본문이 있습니다.

MAI Image 2.7을 사용할 수 있는 곳

Microsoft는 MAI Image 2.7을 호스팅 모델로 제공하며, 다운로드 가능한 가중치는 없습니다. Microsoft Foundry에서는 퍼블릭 프리뷰 상태이며, Microsoft 문서에는 MAI-Image-2.7과 MAI-Image-2.7-Flash(버전 2026-11-02)가 Global Standard 배포로 나와 있습니다. MAI Labs에서도 사용해 볼 수 있지만, Microsoft는 이를 개인적·비상업적 용도로 설명합니다.

PoYo에서는 다른 모든 모델에 쓰는 API 키로 두 모델을 호출할 수 있으며, Azure 구독이나 배포 단계가 필요 없습니다. PoYo의 요청 형식도 Foundry와 다릅니다. 하나의 JSON 엔드포인트가 편집용 image_urls를 받으며(Foundry는 별도의 multipart 편집 엔드포인트 사용), 원시 너비와 높이 대신 종횡비와 1K/2K 또는 사용자 지정 크기를 선택합니다.

요청별 라우팅

요청호출할 모델
최종 히어로 이미지, 정밀한 편집, 텍스트가 많은 포스터와 패키지mai-image-2.7
초안, 미리보기, 썸네일, 대량 카탈로그 및 스티커 작업mai-image-2.7-flash
실시간 웹 정보가 필요한 프롬프트(시사, 실제 장소)enable_web_search를 사용하는 mai-image-2.6, MAI Image 2.6 참조

MAI Image 2.7은 MAI Image 2.6에 있는 웹 검색 옵션을 받지 않습니다. 그 외 2.6 요청의 내용은 모두 그대로 사용할 수 있으며, 필드 변경 사항과 마이그레이션 diff는 2.7 vs 2.6 비교에 정리되어 있습니다.

자주 묻는 질문

MAI Image 2.7 API의 모델 ID는 무엇인가요? 플래그십은 mai-image-2.7, Flash는 mai-image-2.7-flash를 사용합니다. mai-image-2-7은 PoYo 페이지 슬러그일 뿐이며 모델 ID로는 거부됩니다.

MAI Image 2.7 API 가격은 얼마인가요? PoYo에서 MAI Image 2.7은 텍스트 입력, 이미지 입력, 출력 100만 토큰당 $5.00 / $8.00 / $34.00이고, Flash는 $1.75 / $2.50 / $10.00입니다. 1024x1024 이미지는 MAI Image 2.7에서 약 $0.035, Flash에서 약 $0.0102입니다.

MAI Image 2.7 API는 새 이미지를 생성할 수 있나요, 아니면 편집만 하나요? 둘 다 가능합니다. prompt만 있는 요청은 새 이미지를 생성합니다. image_urls에 URL 1~5개를 추가하면 같은 요청이 편집 또는 다중 이미지 합성이 됩니다.

MAI Image 2.7 API는 투명 배경을 지원하나요? 네. "background": "transparent"를 "output_format": "png" 또는 "webp"와 함께 보내세요. 출시일 Flash 테스트에서 완전히 투명한 배경의 1024x1024 RGBA PNG가 반환되었습니다.

MAI Image 2.7 API가 반환할 수 있는 가장 큰 이미지는? 4,194,304픽셀입니다. 예를 들어 2048x2048이나 사용자 지정 3072x1344입니다. 2K에서 16:9는 2720x1536을 반환합니다.

MAI Image 2.7 API 요청은 얼마나 걸리나요? 2026년 11월 19일 테스트에서 2K 16:9 이미지는 MAI Image 2.7에서 약 66초, Flash에서 약 42초가 걸렸습니다. 요청을 열어 둔 채 기다리지 말고 기한이 있는 폴링이나 callback_url을 사용하세요.

Share: