개요
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초가 걸립니다.텍스트-이미지 API
이미지 편집 API
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을 추가하세요 …
- 모델 이름: 플래그십
MAI-Image-2.6, 고속 변형MAI-Image-2.6-Flash. 모델 이름은 대소문자를 구분합니다. 모두 소문자로 된 이름을 사용하면 503이 반환되며, 이는 장애처럼 보이지만 실제로는 잘못된 이름 때문입니다 …
총 11개의 요구 사항입니다. 아래 버튼을 사용하여 전체 프롬프트를 복사하세요.
이 프롬프트가 방지하는 문제
이 프롬프트가 방지하는 문제
APIYI에서 MAI-Image 2.6을 사용하는 이유
Microsoft 공식 채널
/v1/images/generations 및 /v1/images/edits 엔드포인트를 사용하며, 응답 형식은 OpenAI 이미지 API와 같습니다.이미지당 과금
어디서나 액세스
api.apiyi.com에 직접 액세스할 수 있으며, 모든 모델에 하나의 키를 사용할 수 있습니다.전체 모델 라인업
주요 기능
중국어 텍스트 렌더링
고정밀 편집
사용자 지정 캔버스
width + height 조합을 지원하며, 긴 변은 최대 3072까지 가능합니다(예: 3072×768 배너). 면적 상한은 1536×1536입니다.두 가지 속도 등급
샘플 결과
중국어 텍스트 렌더링 (MAI-Image-2.6-Flash, prompt에서 방문객을 환영하는 중국어 간판을 요청함): 간판, 등불, 세로 대련, 칠판 모두 읽을 수 있는 중국어로 표시됩니다.

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 미만으로 유지합니다. 대규모 배치 워크로드의 경우 사전에 지원팀에 문의하시기 바랍니다.기술 사양
엔드포인트
주요 매개변수
width 및 height (출력 크기)
n (이미지 수)
- 텍스트-이미지:
n는 영향을 주지 않습니다. 2, 4 또는 10을 전송해도 이미지 1개만 반환되며(1개로 과금됩니다) 추가 이미지를 받으려면 병렬 요청을 전송하십시오. - 편집:
n이 작동합니다.n=2를 전송하면 이미지 2개가 반환되며 2개로 과금됩니다.
모범 사례
사용 사례에 따라 변형을 선택합니다
MAI-Image-2.6-Flash을(를) 사용합니다. 히어로 포스터, 복잡한 구성 또는 높은 품질 기준이 필요한 경우에는 → MAI-Image-2.6을(를) 사용합니다. 매개변수는 동일하므로 모델 이름만 변경하면 됩니다.렌더링할 텍스트를 인용합니다
편집할 때는 '나머지는 모두 변경하지 않음'이라고 명시합니다
캔버스를 변경하면 이미지가 다시 구성됩니다
width / height을 전달하면 모델은 이미지를 자르거나 여백을 추가하는 대신 장면을 다시 배치합니다. 부분 편집에서는 크기를 생략하면 출력이 원본의 비율을 따르며, 16의 배수에 맞춰 조정됩니다(예: 1344×756 입력 → 1360×768 출력).여러 이미지가 필요합니까? 병렬 요청을 전송합니다
오류 코드 및 재시도
429만 지수 백오프를 적용하여 최대 3회 재시도할 가치가 있습니다. 클라이언트 타임아웃으로 삭제된 요청도 여전히 과금된다는 점에 유의하고, 먼저 타임아웃을 늘리십시오.FAQ
response_format을 보내면 400이 반환되는 이유는 무엇입니까?
response_format을 보내면 400이 반환되는 이유는 무엇입니까?
b64_json만 반환하며 response_format 매개변수를 허용하지 않습니다. "b64_json"도 400 Invalid parameters: response_format을 반환합니다.gpt-image / DALL·E에서 마이그레이션한 코드에는 이 값이 명시적으로 설정되어 있는 경우가 많습니다. 이를 제거하십시오. 이미지는 여전히 data[0].b64_json에 있습니다. seed 및 negative_prompt에도 동일하게 적용됩니다.size: 1536x1024를 전달했는데 결과가 여전히 정사각형인 이유는 무엇입니까?
size: 1536x1024를 전달했는데 결과가 여전히 정사각형인 이유는 무엇입니까?
size을 읽지 않습니다. 이 값을 조용히 무시하고 기본값인 1024×1024로 렌더링합니다. 대신 "width": 1536, "height": 1024을 사용하십시오.편집 엔드포인트에서는 size이 작동하지만, 일관성을 위해 두 엔드포인트 모두에서 width + height을 사용하십시오.이미지 URL을 사용하여 편집할 수 있습니까?
이미지 URL을 사용하여 편집할 수 있습니까?
multipart/form-data 파일 업로드만 허용합니다. URL, 데이터 URI 또는 base64 문자열을 image로 전달하면 400을 반환합니다.URL만 있는 경우 먼저 서버에서 다운로드한 다음 업로드하십시오.퓨전을 위해 여러 참조 이미지를 보낼 수 있습니까?
퓨전을 위해 여러 참조 이미지를 보낼 수 있습니까?
- 방법:
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>을 반환합니다.
마스크 인페인팅을 지원합니까?
마스크 인페인팅을 지원합니까?
mask 필드를 전달하면 400 <model> does not support mask edits을 반환합니다. 부분적으로 변경하려면 프롬프트에서 해당 영역을 설명하십시오. 예: “찻주전자만 파란색으로 변경하고, 나머지는 모두 정확히 동일하게 유지하십시오.” 테스트 결과 모델은 이러한 제약을 매우 잘 따릅니다.Cherry Studio / LobeChat에서 사용할 수 있습니까?
Cherry Studio / LobeChat에서 사용할 수 있습니까?
/v1/chat/completions을 사용하며, 이 시리즈에서는 404를 반환합니다. OpenAI Images API를 지원하는 도구를 사용하거나, 이 문서의 코드 샘플을 사용하여 직접 호출하십시오.요청당 이미지를 몇 개 보낼 수 있습니까?
요청당 이미지를 몇 개 보낼 수 있습니까?
n을 보내더라도 이미지 1개를 받고 이미지 1개에 대한 비용을 지불합니다. 더 많은 이미지가 필요하면 병렬 요청을 보내십시오.편집 엔드포인트에서는 n이 작동합니다. n=2은 이미지 2개를 반환하며 이미지 2개로 과금됩니다.사용량의 token 수를 사용하여 과금을 대조할 수 있습니까?
사용량의 token 수를 사용하여 과금을 대조할 수 있습니까?
usage.prompt_tokens은 항상 이미지 수 × 1000이고 output_tokens은 항상 0입니다. 이는 자리표시자일 뿐입니다. 이 시리즈는 이미지 단위로 과금되며 APIYI 콘솔의 청구 내역이 기준이 됩니다.검열은 얼마나 엄격합니까? 차단되면 어떻게 표시됩니까?
검열은 얼마나 엄격합니까? 차단되면 어떻게 표시됩니까?
400 content_safety_violation이 반환되며 메시지에 구체적인 이유가 포함됩니다. 프롬프트 수준의 차단은 일반적으로 5~8초 이내에 반환됩니다. 일부 차단은 생성 후 적용되며 일반 이미지와 거의 같은 시간이 걸립니다. 동일한 프롬프트로 다시 시도해도 도움이 되지 않으므로 표현을 바꾸십시오.스트리밍을 지원합니까?
스트리밍을 지원합니까?
사용 가능한 채널이 없다는 503 오류가 발생합니까?
사용 가능한 채널이 없다는 503 오류가 발생합니까?
MAI-Image-2.6 또는 MAI-Image-2.6-Flash이어야 하며, mai-image-2.6-flash은 503을 반환합니다.관련 문서
- MAI-Image 2.6 텍스트-이미지 API - Playground가 포함된 API 레퍼런스
- MAI-Image 2.6 이미지 편집 API - 참조 이미지 편집
- 이미지 API 필수 사항 및 모범 사례 - 타임아웃, 연결 끊김, 압축
- 충전 보너스 프로모션