메인 콘텐츠로 건너뛰기

개요

MAI-Image 2.6은 Microsoft AI의 자체 이미지 생성 모델로, 2026-09-04에 출시되었으며 Microsoft Foundry에서 공개 프리뷰로 제공됩니다. 출시 당시 Arena의 텍스트-이미지 및 이미지 편집 부문에서 모두 2위를 기록했으며, Artificial Analysis의 이미지 편집 부문에서 1위를 기록했습니다(2026-09-04 기준, Microsoft 발표에 따름). APIYI는 Microsoft의 공식 채널을 통해 두 가지 변형을 제공합니다. 두 변형은 동일한 엔드포인트와 매개변수를 공유합니다.
  • MAI-Image-2.6: 품질과 정밀도에 맞게 조정된 플래그십 모델
  • MAI-Image-2.6-Flash: 빠른 변형입니다. Microsoft에 따르면 GPT-Image-2-Medium보다 2.8배 빠르게 생성하며, 높은 처리량이 필요한 프로덕션 워크로드에 적합합니다.
주요 특징: 뛰어난 중국어 텍스트 렌더링(상점 간판, 세로 대련, 손글씨가 글자 단위로 정확하게 표현됨), 높은 충실도의 편집(요청한 부분만 변경되고 나머지는 픽셀 단위로 동일하게 유지됨), width + height을 통해 원하는 모든 캔버스 사용 가능(최대 1536×1536 영역), 그리고 크기에 관계없이 이미지당 동일한 정액 요금을 제공합니다. 1024×1024 이미지를 생성하는 데 Flash에서는 약 17초, 2.6에서는 약 30초가 걸립니다.
📌 시작하기 전에 알아야 할 세 가지
  1. 지원되는 엔드포인트는 두 개뿐입니다: /v1/images/generations(텍스트-이미지, JSON) 및 /v1/images/edits(편집, multipart/form-data)입니다. /v1/chat/completions 및 /v1/responses는 지원되지 않으며 404를 반환합니다.
  2. response_format, seed 또는 negative_prompt를 전송하지 마십시오. 세 항목 모두 즉시 400을 반환합니다. 응답은 항상 data[0].b64_json(PNG)입니다.
  3. width + height로 크기를 설정하고 size는 사용하지 마십시오. 텍스트-이미지 엔드포인트에서는 size가 조용히 무시되며 항상 1024×1024 이미지가 반환됩니다.
모든 이미지 API는 동기식입니다. 비동기 작업 ID는 없습니다. 클라이언트 연결이 끊기면 결과는 손실되지만 요청에는 여전히 과금됩니다. 이 모델에는 넉넉한 타임아웃을 설정하십시오. 이미지 API 핵심 사항 및 모범 사례를 참조하십시오.

텍스트-이미지 API

대화형 Playground를 사용하여 텍스트 prompt에서 이미지를 생성합니다.

이미지 편집 API

1~5개의 참조 이미지와 지침을 업로드하여 여러 이미지 융합을 수행합니다. Playground가 포함되어 있습니다.

AI 에이전트가 대신 통합하도록 하세요

이 프롬프트를 복사하여 Codex / Claude Code / Cursor에 붙여 넣으세요

에이전트는 먼저 이 페이지의 일반 텍스트 버전을 가져온 다음(모든 docs URL 뒤에 .md 추가), 사용자의 스택에 맞는 코드를 작성합니다. 타임아웃, 400을 반환하는 세 가지 매개변수, width/height 대신 size을 사용해야 하는 문제, 파일 업로드만 지원되는 편집 방식 등 일반적인 문제를 명시합니다.

이 프로젝트에 Microsoft MAI-Image 2.6 텍스트-이미지 생성 및 이미지 편집을 통합하거나 디버깅하세요.

코드를 작성하기 전에 문서를 읽으세요. 이 페이지의 일반 텍스트 버전을 확인하려면 https://docs.apiyi.com/en/api-capabilities/mai-image/overview.md를 가져오세요. 자세한 매개변수는 동일한 방식으로 텍스트-이미지 및 이미지 편집 페이지의 텍스트 끝에 .md을 추가하세요 …

  1. 모델 이름: 플래그십 MAI-Image-2.6, 고속 변형 MAI-Image-2.6-Flash. 모델 이름은 대소문자를 구분합니다. 모두 소문자로 된 이름을 사용하면 503이 반환되며, 이는 장애처럼 보이지만 실제로는 잘못된 이름 때문입니다 …

총 11개의 요구 사항입니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하세요.

APIYI에서 MAI-Image 2.6을 사용하는 이유

Microsoft 공식 채널

Microsoft의 공식 채널을 통해 제공됩니다. Microsoft Foundry에서 동일한 이름으로 제공되는 모델과 같은 모델입니다. 표준 /v1/images/generations 및 /v1/images/edits 엔드포인트를 사용하며, 응답 형식은 OpenAI 이미지 API와 같습니다.

이미지당 과금

제공업체는 token 기준으로 과금하므로 이미지가 클수록 비용이 증가합니다. APIYI는 크기와 관계없이 이미지당 고정 요금을 부과합니다. 768×768과 1536×1536은 동일한 비용이며, 참조 이미지 1개를 사용하는 편집과 5개를 사용하는 편집도 비용이 같으므로 이미지 단위로 예산을 책정할 수 있습니다.

어디서나 액세스

Azure 계정이나 해외 서버가 필요하지 않습니다. 데이터 센터, 가정용 네트워크 또는 해외 노드에서 api.apiyi.com에 직접 액세스할 수 있으며, 모든 모델에 하나의 키를 사용할 수 있습니다.

전체 모델 라인업

다양한 사용 사례에 맞게 GPT-Image-2, Nano Banana 2, Seedream, FLUX와 함께 사용할 수 있습니다.

주요 기능

중국어 텍스트 렌더링

중국어 상점 간판, 세로 대련, 칠판 손글씨가 글자 단위로 정확하게 표현됩니다. 포스터, 제품 이미지, 굿즈에 적합합니다.

고정밀 편집

“찻주전자를 코발트 블루로 바꿔 주세요”라고 지시하면 찻주전자만 변경되며, 치수 라벨과 다른 객체는 픽셀 단위로 동일하게 유지됩니다.

사용자 지정 캔버스

모든 width + height 조합을 지원하며, 긴 변은 최대 3072까지 가능합니다(예: 3072×768 배너). 면적 상한은 1536×1536입니다.

두 가지 속도 등급

1024×1024 이미지는 Flash에서 약 17초, 2.6에서 약 30초가 소요되며, 동시 요청 10개에서도 지연 시간이 안정적으로 유지됩니다.

샘플 결과

중국어 텍스트 렌더링 (MAI-Image-2.6-Flash, prompt에서 방문객을 환영하는 중국어 간판을 요청함): 간판, 등불, 세로 대련, 칠판 모두 읽을 수 있는 중국어로 표시됩니다.
MAI-Image-2.6-Flash 중국어 텍스트 렌더링: 중국어 환영 간판이 있는 전통 찻집
참조 이미지 편집 (MAI-Image-2.6-Flash, “찻주전자를 짙은 코발트 블루 유약으로 변경하고 나머지는 모두 동일하게 유지”라는 지시): 왼쪽은 원본이고 오른쪽은 결과입니다. 찻주전자의 색상만 변경되며, 치수 라벨과 다른 객체는 그대로 유지됩니다.
MAI-Image-2.6-Flash 편집 예시: 크림색 찻주전자를 코발트 블루로 변경했으며 나머지는 모두 동일함

가격

모델 가격은 변경될 수 있습니다. 위 표는 참고용일 뿐이며, 상단 탐색 메뉴의 모델 가격 탭이 기준입니다: 모델 가격.
과금 참고 사항
  • 크기와 관계없이 이미지당 과금: 768×768과 1536×1536은 비용이 동일하며, prompt 길이는 가격에 영향을 주지 않습니다.
  • 편집 비용은 텍스트-이미지 생성과 동일: 출력 이미지 기준으로 과금되며, 참조 이미지 1장 또는 5장의 비용은 동일합니다. 편집 엔드포인트의 n=2은 이미지 2장으로 과금됩니다.
  • 400으로 실패하는 요청(검열 또는 잘못된 매개변수)은 이미지를 생성하지 않습니다.
  • 응답의 usage 필드와 대조하지 마십시오: prompt_tokens은 항상 이미지 수 × 1000인 자리 표시자입니다. 콘솔 청구 내역이 기준입니다.
  • 충전 보너스 프로모션과 중복 적용됩니다.

그룹 및 토큰

이 시리즈는 Default 그룹에 속합니다. 새로 생성된 토큰은 모두 이를 호출할 수 있으며, 애플리케이션은 필요하지 않습니다.
토큰 과금 모드: 이 시리즈에는 Pay-as-you-go Priority 및 Per-request를 모두 사용할 수 있습니다. Pay-as-you-go Priority를 권장하므로 동일한 토큰으로 플랫폼에서 토큰 과금 모델도 사용할 수 있습니다.요율: 단일 키를 50 RPM 미만으로 유지합니다. 대규모 배치 워크로드의 경우 사전에 지원팀에 문의하시기 바랍니다.

기술 사양

엔드포인트

❌ 채팅 엔드포인트는 지원되지 않습니다/v1/chat/completions 및 /v1/responses은 이 시리즈에서 **404 Requested path is not found**을 반환합니다. Cherry Studio 및 LobeChat과 같은 채팅 클라이언트는 목록의 모든 모델에 채팅 요청을 전송하므로, 해당 클라이언트에서는 MAI-Image를 선택하지 마십시오. Images API를 지원하는 도구를 사용하거나 자체 코드에서 호출하십시오.
✅ 편집 엔드포인트는 multipart 파일 업로드만 허용합니다image을 URL, data URI 또는 원시 base64로 지정하여 JSON을 /v1/images/edits으로 전송하면 400을 반환합니다:
-F "[email protected]"을 사용하여 로컬 파일을 직접 업로드하십시오. 이미지 호스팅은 필요하지 않습니다. 전체 예시는 이미지 편집 API를 참조하십시오.
기본 도메인은 https://api.apiyi.com이고, 백업 도메인은 https://b.apiyi.com입니다.

주요 매개변수

width 및 height (출력 크기)

일반적인 캔버스 크기(모두 영역 상한 이내):
size은 두 엔드포인트에서 다르게 작동합니다: 텍스트-이미지에서는 자동으로 무시되며(항상 1024×1024), 편집 엔드포인트에서는 적용됩니다. 혼동을 피하려면 두 엔드포인트 모두에서 width + height을 사용하십시오.

n (이미지 수)

  • 텍스트-이미지: n는 영향을 주지 않습니다. 2, 4 또는 10을 전송해도 이미지 1개만 반환되며(1개로 과금됩니다) 추가 이미지를 받으려면 병렬 요청을 전송하십시오.
  • 편집: n이 작동합니다. n=2를 전송하면 이미지 2개가 반환되며 2개로 과금됩니다.

모범 사례

1

사용 사례에 따라 변형을 선택합니다

일괄 생성 또는 지연 시간에 민감한 작업에는 → MAI-Image-2.6-Flash을(를) 사용합니다. 히어로 포스터, 복잡한 구성 또는 높은 품질 기준이 필요한 경우에는 → MAI-Image-2.6을(를) 사용합니다. 매개변수는 동일하므로 모델 이름만 변경하면 됩니다.
2

렌더링할 텍스트를 인용합니다

이미지에 표시할 텍스트는 따옴표로 묶고 배치할 위치를 지정합니다. 예를 들어 “Grand Opening”이라고 쓰인 표지판과 같이 지정할 수 있습니다. 모델은 인용된 텍스트를 매우 정확하게 재현합니다.
3

편집할 때는 '나머지는 모두 변경하지 않음'이라고 명시합니다

원본을 최대한 유지하려면 “찻주전자를 코발트 블루로 바꾸고, 나머지는 모두 정확히 동일하게 유지합니다”와 같은 지침을 작성합니다.
4

캔버스를 변경하면 이미지가 다시 구성됩니다

원본과 다른 화면 비율의 width / height을 전달하면 모델은 이미지를 자르거나 여백을 추가하는 대신 장면을 다시 배치합니다. 부분 편집에서는 크기를 생략하면 출력이 원본의 비율을 따르며, 16의 배수에 맞춰 조정됩니다(예: 1344×756 입력 → 1360×768 출력).
5

여러 이미지가 필요합니까? 병렬 요청을 전송합니다

텍스트-이미지 생성은 호출당 이미지 한 장을 반환하므로, 이미지 4장을 얻으려면 병렬 요청 4개를 전송합니다. 동시 요청 10개를 보낸 경우에도 테스트에서 지연 시간은 단일 요청과 동일했습니다.

오류 코드 및 재시도

클라이언트 안내: 위의 4xx / 500 오류는 결정적이므로 재시도해도 소용이 없습니다. 대신 이러한 오류가 발생하면 알림을 설정하십시오. 네트워크 타임아웃과 429만 지수 백오프를 적용하여 최대 3회 재시도할 가치가 있습니다. 클라이언트 타임아웃으로 삭제된 요청도 여전히 과금된다는 점에 유의하고, 먼저 타임아웃을 늘리십시오.

FAQ

이 시리즈는 b64_json만 반환하며 response_format 매개변수를 허용하지 않습니다. "b64_json"도 400 Invalid parameters: response_format을 반환합니다.gpt-image / DALL·E에서 마이그레이션한 코드에는 이 값이 명시적으로 설정되어 있는 경우가 많습니다. 이를 제거하십시오. 이미지는 여전히 data[0].b64_json에 있습니다. seed 및 negative_prompt에도 동일하게 적용됩니다.
텍스트-이미지 엔드포인트는 size을 읽지 않습니다. 이 값을 조용히 무시하고 기본값인 1024×1024로 렌더링합니다. 대신 "width": 1536, "height": 1024을 사용하십시오.편집 엔드포인트에서는 size이 작동하지만, 일관성을 위해 두 엔드포인트 모두에서 width + height을 사용하십시오.
아니요. 편집 엔드포인트는 multipart/form-data 파일 업로드만 허용합니다. URL, 데이터 URI 또는 base64 문자열을 image로 전달하면 400을 반환합니다.URL만 있는 경우 먼저 서버에서 다운로드한 다음 업로드하십시오.
예, 이미지 1~5개(2026-10-07부터)이며, 이미지 1개를 보낼 때와 가격이 동일합니다.
  • 방법: image[] 필드를 curl -F "image[][email protected]" -F "image[][email protected]" 반복합니다. OpenAI SDK를 사용하는 경우 목록 client.images.edit(image=[f1, f2])을 전달합니다.
  • 이미지 참조 방법: 업로드 순서에 따라 이미지 1, 이미지 2, …로 번호가 지정됩니다. 예: “이미지 2의 여우를 이미지 1의 장면에 넣고, 이미지 1의 나머지 부분은 모두 변경하지 마십시오”
  • image + image2을 사용하지 마십시오: 200을 반환하지만 두 번째 이미지는 삭제되고 첫 번째 이미지만 사용됩니다.
  • 이미지가 5개를 초과하면 400 at most 5 reference images are accepted for <model>을 반환합니다.
전체 예시는 이미지 편집 API를 참조하십시오.
아니요. mask 필드를 전달하면 400 <model> does not support mask edits을 반환합니다. 부분적으로 변경하려면 프롬프트에서 해당 영역을 설명하십시오. 예: “찻주전자만 파란색으로 변경하고, 나머지는 모두 정확히 동일하게 유지하십시오.” 테스트 결과 모델은 이러한 제약을 매우 잘 따릅니다.
권장하지 않습니다. 이러한 채팅 클라이언트는 /v1/chat/completions을 사용하며, 이 시리즈에서는 404를 반환합니다. OpenAI Images API를 지원하는 도구를 사용하거나, 이 문서의 코드 샘플을 사용하여 직접 호출하십시오.
텍스트-이미지는 항상 1개를 반환합니다. 어떤 n을 보내더라도 이미지 1개를 받고 이미지 1개에 대한 비용을 지불합니다. 더 많은 이미지가 필요하면 병렬 요청을 보내십시오.편집 엔드포인트에서는 n이 작동합니다. n=2은 이미지 2개를 반환하며 이미지 2개로 과금됩니다.
아니요. usage.prompt_tokens은 항상 이미지 수 × 1000이고 output_tokens은 항상 0입니다. 이는 자리표시자일 뿐입니다. 이 시리즈는 이미지 단위로 과금되며 APIYI 콘솔의 청구 내역이 기준이 됩니다.
이 시리즈는 Microsoft의 공식 콘텐츠 안전 정책을 사용하며 상당히 엄격합니다. 실제 유명인, 고어, 잘 알려진 IP 캐릭터(예: Disney), 누드가 차단됩니다.차단되면 400 content_safety_violation이 반환되며 메시지에 구체적인 이유가 포함됩니다. 프롬프트 수준의 차단은 일반적으로 5~8초 이내에 반환됩니다. 일부 차단은 생성 후 적용되며 일반 이미지와 거의 같은 시간이 걸립니다. 동일한 프롬프트로 다시 시도해도 도움이 되지 않으므로 표현을 바꾸십시오.
아니요. 일반 동기식 요청으로 호출하고 전체 응답이 반환될 때까지 기다리십시오.
가장 일반적인 원인은 모델 이름의 대소문자가 잘못된 것입니다. 이름은 정확히 MAI-Image-2.6 또는 MAI-Image-2.6-Flash이어야 하며, mai-image-2.6-flash은 503을 반환합니다.

관련 문서