Skip to Content
모델 사용법MAI Image

MAI Image 시리즈

Microsoft의 이미지 생성 및 편집 모델로, 모두 세 가지입니다. OpenAI 호환 API로 호출하며 사용법은 GPT Image와 거의 같습니다. 텍스트로 이미지 생성에는 /v1/images/generations를, 편집에는 /v1/images/edits를 사용합니다.

모델 선택

모델 ID(호출 시 그대로 복사)
MAI Image 2.5 Promicrosoft/mai-image-2.5-pro복잡한 구도, 인물과 사물의 일관성
MAI Image 2.5microsoft/mai-image-2.5정밀한 부분 수정
MAI Image 2.5 Flashmicrosoft/mai-image-2.5-flash낮은 지연 시간, 일괄 생성

세 모델의 파라미터는 같으며, 실측 결과 1024×1024 이미지 생성에 약 12~25초가 걸렸습니다. 실시간 가격은 모델 페이지 를 참고하십시오.

텍스트로 이미지 생성

mai_image.py
import base64
from openai import OpenAI
 
client = OpenAI(api_key="YOUR_OFOX_API_KEY", base_url="https://api.ofox.io/v1", timeout=600)
 
resp = client.images.generate(
    model="microsoft/mai-image-2.5-flash",
    prompt="흰 테이블 위에 놓인 빨간 사과 하나",
    size="1024x1024",
)
 
with open("output.png", "wb") as f:
    f.write(base64.b64decode(resp.data[0].b64_json))

크기(size)

요점size는 비율만 결정하며 출력은 약 100만 픽셀입니다. 더 큰 크기를 전달해도 해상도는 높아지지 않습니다.
요청한 size실제 출력
생략1024×1024
1024x1024, 2048x2048, 4096x40961024×1024
1536x10241248×832
1024x1536832×1248
100x100768×768
  • 출력은 요청한 비율을 유지하면서 총 픽셀 수를 약 100만으로 조정합니다. 너무 작은 크기를 전달하면 768×768로 출력됩니다.
  • 더 높은 해상도가 필요하면 Nano Banana Pro(최대 4K) 또는 GPT Image를 사용하십시오.

이미지 편집

Terminal
curl https://api.ofox.io/v1/images/edits \
  --max-time 600 \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -F model=microsoft/mai-image-2.5 \
  -F prompt="사과를 보라색으로 바꾸고, 나머지는 그대로 두세요" \
  -F image=@apple.jpg \
  | jq -r '.data[0].b64_json' | base64 --decode > apple_purple.png

참고 이미지는 입력 토큰에 포함되며, 응답의 usage.input_tokens_details.image_tokens에서 확인할 수 있습니다. 실측 결과 768×768 참고 이미지 한 장이 576 토큰으로 계산되었습니다.

자주 발생하는 오류

오류원인해결 방법
요청 타임아웃클라이언트 타임아웃 설정이 너무 짧음타임아웃을 300초 이상으로 설정
404 model_not_found모델 ID 철자 오류이 페이지에서 모델 ID를 복사

여러 장이 필요하면 요청을 여러 번 동시에 보내십시오. 요청마다 한 장이 생성됩니다.

자주 묻는 질문

MAI Image로 2K나 4K 이미지를 생성할 수 있습니까?

없습니다. size는 비율만 결정하며 출력 총 픽셀 수는 약 100만입니다. 실측 결과 2048x2048이나 4096x4096을 전달해도 1024x1024로 출력되었습니다. 더 높은 해상도가 필요하면 Nano Banana Pro 또는 GPT Image를 사용하십시오.

MAI Image로 이미지를 편집하려면 어떻게 합니까?

/v1/images/edits를 사용하여 multipart 폼으로 image 파일을 업로드하십시오. 작성법은 GPT Image와 같습니다.

마지막 업데이트
Qwen-ImageSeedance