APIMart
MAI Image 2.7 모델 아이콘
이미지

MAI Image 2.7 API

Microsoft MAI Image 2.7 이미지 편집 모델에 맞는 수정 방향을 계획하세요. MAI Image API Playground에서 원본과 명확한 지시를 조합해 장면, 조명, 문자와 유지할 세부 사항을 설명할 수 있습니다.

이미지 편집장면과 조명문자와 세부 사항

MAI Image 2.7 API 설정 개요

  • 로컬 파일 또는 URL 원본 이미지
  • 프롬프트로 작성하는 편집 지시
  • Form 및 JSON 설정
Input

변경할 부분과 유지할 세부 사항을 지정하세요.

출력

이미지를 선택하고 변경 내용을 설명하세요.

MAI Image 2.7 API로 구체적인 편집 계획

원본과 명확한 수정 목표부터 시작하세요. 편집 작업 공간에서 바꿀 부분과 유지할 구도, 재질, 세부 사항을 구분해 정리할 수 있습니다.

MAI Image 2.7 API 호출 예제: 이미지 편집

예제 코드로 원본 이미지와 편집 지시가 포함된 이미지 편집 요청을 구성하고, 작업을 조회해 결과를 가져오는 흐름을 확인하세요.

  1. 1

    MAI Image 2.7 API 요청 인증하기

    APIMart API 키를 APIMART_API_KEY 환경 변수에 저장하세요. 편집 요청과 작업 조회 시 모두 Authorization: Bearer <key>로 전달합니다.

  2. 2

    이미지 편집 작업 제출하기

    POST /v1/images/generations로 model을 mai-image-2.7로 설정하고, prompt에 편집 지시를 입력하며, image_urls에 HTTP 또는 HTTPS 원본 이미지 URL 1개를 담아 전송합니다. 응답의 data[0].task_id에서 작업 ID를 읽습니다.

  3. 3

    편집한 이미지 가져오기

    GET /v1/tasks/{task_id}로 작업을 조회합니다. 상태가 completed이면 data.result.images[0].url[0]에서 이미지 URL을 읽습니다. 상태가 failed이면 data.error.message에서 실패 원인을 확인합니다.

    APIMart 인증과 API의 일반적인 사용 방법은 APIMart 문서를 참고하세요.

POST /v1/images/generations
curl -X POST https://api.apimart.ai/v1/images/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mai-image-2.7",
    "prompt": "이 이미지의 제품을 부드러운 아침 햇살이 비치는 대리석 주방 조리대 위에 놓고, 제품의 모양과 라벨은 그대로 유지하세요.",
    "image_urls": [
      "https://example.com/source-image.jpg"
    ]
  }'

MAI Image 2.7 API 파라미터

파라미터타입필수기본값설명
modelstring필수기본값: mai-image-2.7이 페이지의 예제에서 사용하는 모델 값: mai-image-2.7.
promptstring필수기본값: —원하는 편집 내용과 원본 이미지에서 유지할 요소를 설명합니다.
image_urlsarray필수기본값: —편집할 원본 이미지의 HTTP 또는 HTTPS URL을 정확히 1개 포함하는 배열입니다.