how-tos

MAI Image 2.7 API 투명 배경: PNG와 WebP 에셋 만들기

Poyo.ai Team
6 min read
Share:

MAI Image 2.7 API로 만든 투명 PNG와 WebP 에셋

MAI Image 2.7 API는 실제 알파 채널이 있는 이미지를 반환할 수 있어서, 제품 누끼, 로고, 아이콘, 스티커를 마스킹 작업 없이 어떤 배경에든 바로 올릴 수 있습니다. PoYo에서는 mai-image-2.7과 mai-image-2.7-flash 모두에서 background와 output_format 두 필드로 지정합니다. 출시일 테스트에서 Flash의 1024x1024 투명 PNG는 현재 요율 기준 2.062크레딧, 약 $0.0103입니다. 코드에 연결하기 전에 MAI Image 2.7 모델 페이지에서 먼저 사용해 보세요.

투명 배경에 대한 Microsoft의 설명

Microsoft의 출시 글은 "both models support transparent backgrounds for ready-to-use product images"라고 하며, 추가 용도로 로고, 아이콘, 일러스트를 꼽습니다. Microsoft의 Foundry 문서는 투명 배경을 MAI-Image-2.7이 이전 MAI 이미지 모델 대비 추가한 기능으로 소개하며 "for assets such as product imagery, logos, icons, and design elements that need to be placed over other content"라고 설명합니다. MAI Image 2.6에는 이런 옵션이 없습니다.

두 가지 필드

필드값기본값규칙
backgroundopaque, transparentopaquetransparent는 알파 채널이 있는 이미지를 반환
output_formatpng, jpeg, webppngtransparent는 png 또는 webp 필요

기본값이 opaque와 png이므로 투명 배경을 얻으려면 background를 명시적으로 보내야 합니다. PNG라면 output_format은 생략할 수 있지만, 보내 두면 로그에서 의도가 분명해집니다. "background": "transparent"와 "output_format": "jpeg"의 조합은 JPEG에 알파 채널이 없으므로 유효하지 않습니다. 제출 전에 실패하도록 이 조합은 직접 검증하세요.

나머지 필드는 평소와 같이 동작합니다. size(기본값 1:1, 모든 프리셋 비율 또는 최대 4,194,304픽셀의 사용자 지정 WIDTHxHEIGHT), resolution(1K 또는 2K), 선택 사항인 callback_url입니다. 전체 필드 규칙은 API 레퍼런스에 있습니다.

요청 본문

MAI Image 2.7 API로 투명 PNG

Flash에서 1K 정사각형 스티커로, 필드 설정은 측정한 실행과 같습니다(프롬프트는 예시입니다).

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

투명 WebP 로고

PoYo 문서에 있는 예시로, 플래그십을 사용합니다.

{
  "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도 알파를 담을 수 있고 보통 PNG보다 파일이 작아 웹 페이지에 적합합니다. PNG는 인쇄 워크플로와 PNG를 기대하는 디자인 도구에 더 안전한 선택입니다.

두 요청 모두 task_id를 반환합니다. status가 finished가 될 때까지 GET https://api.poyo.ai/api/generate/status/{task_id}를 폴링한 다음 data.files[0].file_url을 다운로드하세요. 완전한 폴링 루프는 MAI Image 2.7 API 가이드에 있습니다.

실측: 출시일의 투명 스티커

PoYo 팀이 2026년 11월 19일 PoYo 프로덕션 API에서 실행했습니다.

설정값
모델mai-image-2.7-flash
필드size: "1:1", resolution: "1K", background: "transparent", output_format: "png"
출력1024x1024 PNG, RGBA
배경실제 알파: 피사체 주변이 완전히 투명
현재 요율 기준 비용2.062크레딧(약 $0.0103)
시간약 42초, 몇 초마다 폴링한 제출부터 결과까지

추정치: 1024x1024는 약 1,024 출력 토큰으로, 100만당 2,000크레딧이면 2.048크레딧입니다. 나머지 0.014크레딧은 100만당 350크레딧 기준 약 40 프롬프트 토큰과 일치합니다. 즉 투명 이미지도 같은 크기의 다른 이미지와 똑같이 과금되었습니다. 가격표에 투명 배경 추가 요금은 없습니다.

코드로 알파 채널 확인하기

파일 확장자를 믿지 말고, 에셋 라이브러리에 넣기 전에 다운로드한 이미지에 실제로 투명 픽셀이 있는지 확인하세요. 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

lo == 0이고 완전히 투명한 픽셀이 의미 있는 비율로 있으면 쓸 수 있는 누끼입니다. 체커보드를 그린 이미지라면 lo == 255로 모든 픽셀이 불투명합니다. 임계값은 자신의 에셋에 맞게 정하세요. 화면 전체를 채우는 일러스트는 가운데에 놓인 아이콘보다 빈 공간이 적습니다.

깔끔한 누끼를 위한 프롬프트

알파 채널은 모델이 처리하지만, 피사체를 분리하기 쉬운지는 여전히 프롬프트가 결정합니다.

  • 피사체가 단독이라고 쓰세요. PoYo 문서 예시는 "clean edges, no background"로 끝납니다. Microsoft Foundry의 투명 이미지 예시는 "full body, centered, no shadow"를 사용합니다.
  • 장면을 나타내는 단어는 피하세요. "On a table", "in a studio", "with a shadow"는 피사체 바깥에 있는 것을 요구합니다.
  • 스티커에는 외곽선을 요청하세요. 두꺼운 흰색 테두리는 밝은 배경과 어두운 배경 모두에서 잘 보입니다.
  • 텍스트는 따옴표로 감싸세요. 에셋에 단어나 로고 문구가 들어가면, 문서가 이미지 내 텍스트에 권장하는 대로 따옴표로 감쌉니다.

투명 에셋 대량 생성 비용

출력 토큰은 픽셀 수에만 좌우되므로 투명 배경도 불투명 출력과 비용이 같습니다. 이미지당 출력 토큰 비용:

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

Flash 스티커당 실측 2.062크레딧 기준으로 1,000장이면 약 2,062크레딧, 대략 $10.31입니다. 아이콘 세트와 카탈로그 누끼에는 Flash를, 브랜드 로고나 히어로 제품 사진처럼 단일 에셋을 최고 품질로 만들어야 할 때는 MAI Image 2.7을 쓰세요. 가격 글과 Flash vs 2.7 비교에서 더 자세히 다룹니다.

자주 쓰는 투명 에셋 작업별 설정

작업모델size / resolutionoutput_format
채팅·앱 스티커 대량 생성mai-image-2.7-flash1:1, 1Kpng 또는 webp
웹사이트 아이콘과 일러스트mai-image-2.7-flash1:1, 1Kwebp
이커머스 제품 누끼mai-image-2.71:1 또는 3:4, 2Kpng
인쇄·슬라이드용 브랜드 로고mai-image-2.71:1, 2Kpng
히어로 위에 겹칠 와이드 배너 요소mai-image-2.7사용자 지정, 예: 3072x1344webp

이는 규칙이 아니라 출발점입니다. 모든 행이 문서화된 필드만 사용하므로, 요청의 다른 부분을 바꾸지 않고 작업의 티어나 크기를 옮길 수 있습니다. 새로운 유형의 작업은 첫 배치에서 알파 검사를 실행하세요.

투명 결과로 편집하기

스키마는 background: "transparent"와 image_urls를 함께 쓰는 것도 허용합니다. 예를 들어 제품 사진을 누끼로 만들거나, 기존 스티커의 알파 채널을 유지하면서 스타일을 바꿀 수 있습니다. 이 조합은 아직 측정하지 않았으므로, 프로덕션에서 의존하기 전에 자신의 이미지 몇 장으로 테스트하고 위의 알파 검사를 실행하세요.

자주 묻는 질문

MAI Image 2.7 API에서 투명 배경은 어떻게 얻나요? input 안에 "background": "transparent"와 "output_format": "png"(또는 "webp")를 보내세요. 기본값은 불투명 PNG입니다.

MAI Image 2.7 API는 투명 JPEG를 반환할 수 있나요? 아니요. JPEG에는 알파 채널이 없으므로 transparent는 PNG 또는 WebP가 필요합니다.

MAI Image 2.7 Flash는 투명 배경을 지원하나요? 네. mai-image-2.7-flash에서의 출시일 테스트는 완전히 투명한 배경의 1024x1024 RGBA PNG를 반환했으며, 현재 요율 기준 2.062크레딧입니다.

MAI Image 2.7 API에서 투명 배경은 비용이 더 드나요? 아니요. 같은 크기의 다른 이미지와 동일한 텍스트, 이미지 입력, 출력 토큰 요율로 과금됩니다.

MAI Image 2.6으로 투명 PNG를 만들 수 있나요? 아니요. 투명 배경은 MAI Image 2.7의 새 기능입니다. 다른 필드 변경 사항은 MAI Image 2.7 API vs MAI Image 2.6 API를 참조하세요.

Share: