변경할 부분과 유지할 세부 사항을 지정하세요.
이미지를 선택하고 변경 내용을 설명하세요.
원본과 명확한 수정 목표부터 시작하세요. 편집 작업 공간에서 바꿀 부분과 유지할 구도, 재질, 세부 사항을 구분해 정리할 수 있습니다.
예제 코드로 원본 이미지와 편집 지시가 포함된 이미지 편집 요청을 구성하고, 작업을 조회해 결과를 가져오는 흐름을 확인하세요.
APIMart API 키를 APIMART_API_KEY 환경 변수에 저장하세요. 편집 요청과 작업 조회 시 모두 Authorization: Bearer <key>로 전달합니다.
POST /v1/images/generations로 model을 mai-image-2.7로 설정하고, prompt에 편집 지시를 입력하며, image_urls에 HTTP 또는 HTTPS 원본 이미지 URL 1개를 담아 전송합니다. 응답의 data[0].task_id에서 작업 ID를 읽습니다.
GET /v1/tasks/{task_id}로 작업을 조회합니다. 상태가 completed이면 data.result.images[0].url[0]에서 이미지 URL을 읽습니다. 상태가 failed이면 data.error.message에서 실패 원인을 확인합니다.
APIMart 인증과 API의 일반적인 사용 방법은 APIMart 문서를 참고하세요.
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"
]
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "mai-image-2.7",
"prompt": "이 이미지의 제품을 부드러운 아침 햇살이 비치는 대리석 주방 조리대 위에 놓고, 제품의 모양과 라벨은 그대로 유지하세요.",
"image_urls": [
"https://example.com/source-image.jpg"
]
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
model | string | 필수 | 기본값: mai-image-2.7 | 이 페이지의 예제에서 사용하는 모델 값: mai-image-2.7. |
prompt | string | 필수 | 기본값: — | 원하는 편집 내용과 원본 이미지에서 유지할 요소를 설명합니다. |
image_urls | array | 필수 | 기본값: — | 편집할 원본 이미지의 HTTP 또는 HTTPS URL을 정확히 1개 포함하는 배열입니다. |
이미지의 중요한 부분을 중심으로 수정 지시를 정리하세요.
기존 이미지 소재를 위한 구체적인 수정 계획을 준비하세요.
세 단계로 원본과 지시를 함께 검토하세요.
로컬 파일 또는 HTTP/HTTPS 이미지 URL에서 편집할 원본을 선택하세요.
주요 변경부터 설명하고 유지할 물체, 문자, 질감이나 영역을 나열하세요.
Form 또는 JSON에서 원본과 프롬프트를 확인하고 모순되는 지시를 정리하세요.
원본 이미지, 편집 프롬프트와 작업 공간 설정을 알아보세요.
MAI Image 2.7은 Microsoft의 이미지 편집 모델입니다. MAI Image API 작업 공간은 장면, 스타일, 조명, 문자와 복원 편집을 위한 원본과 지시를 정리합니다.
원본을 선택하고 mai-image-api 프롬프트에 원하는 변경을 설명하세요. 유지할 중요한 세부 사항도 명확히 지정하세요.
MAI Image API 작업 공간에서 로컬 파일이나 이미지 URL로 원본 하나를 선택합니다. 다른 이미지의 편집을 준비하려면 현재 원본을 교체하세요.
API 프롬프트에 주요 변경을 먼저 쓰고 환경, 조명과 유지 조건을 추가하세요. 서로 충돌하는 여러 목표보다 구체적인 지시를 우선하세요.
API 프롬프트에 제품 형태, 얼굴 특징, 재질, 문자나 유지할 영역을 명시하세요. 이는 편집 방향이며 정확한 보존을 보장하지는 않습니다.
MAI Image API 지시에 새로운 환경과 피사체의 위치, 크기를 설명하세요. 접촉 그림자와 원근도 포함해 물체와 장면의 관계를 명확히 하세요.
MAI Image API에 빛의 방향, 부드러움, 색과 분위기를 설명하세요. 바꿀 그림자와 반사, 시각적으로 일관되게 유지할 부분도 명시하세요.
MAI Image API 프롬프트에 표현 매체, 색과 질감을 설명하세요. 모호한 스타일 이름만 쓰기보다 유지할 피사체, 자세와 구도도 지정하세요.
API 프롬프트에 정확한 대체 문구를 따옴표로 표시하고 위치와 표면을 명시하세요. 철자, 정렬과 가독성은 별도로 꼼꼼히 확인해야 합니다.
Microsoft MAI Image API에 처리할 흠집, 색바램이나 흔적을 알려주세요. 유지할 얼굴 특징, 질감, 재질과 원래 장면의 중요한 요소도 지정하세요.
MAI Image API 프롬프트에서 왼쪽, 뒤쪽, 접촉, 겹침 같은 상대 위치를 사용하세요. 크기, 원근과 위치 기준이 되는 주변 물체도 포함하세요.
MAI Image API 작업 공간에서 로컬 이미지나 HTTP/HTTPS 이미지 URL을 선택할 수 있습니다. 웹페이지가 아닌 이미지 소재를 가리키는 주소를 사용하세요.
Form과 JSON은 같은 MAI Image API 초안을 나타냅니다. 유효한 JSON은 양식에 반영되고 잘못된 내용은 안내와 함께 편집 텍스트와 이전 양식 초안이 유지됩니다. mai-image-2.7은 이 페이지에서 사용하는 설정 ID입니다.
초기화는 MAI Image API 작업 공간의 현재 원본과 편집 프롬프트를 지우고 처음 설정으로 되돌립니다. 유지할 지시는 먼저 복사하세요.
이 페이지 제목에 쓰인 이름은 표기 방식의 차이이며 API 요청 식별자로 사용해서는 안 됩니다. MAI Image 27, MAIImage 2.7, MAI-Image2.7은 검색에 쓰이는 표기이며 별도 모델이나 API ID를 뜻하지 않습니다. mai-image-2.7은 이 페이지의 설정 ID입니다. 실제 요청 식별자는 해당 API 문서에서 확인하세요.
APIMart에 로그인한 후 페이지 상단의 API Keys를 눌러 키 관리 화면으로 이동하세요. 여기서 APIMart API 키를 생성하고 관리할 수 있습니다. 인증 요건과 요청 식별자는 해당 API 문서를 참고하세요.
같은 카테고리의 다른 모델을 탐색하세요.

Hy Image V3.5 Preview
HY Image 3.5 Preview is an image generation and editing model developed by Tencent Hunyuan. It supports text-to-image creation, reference-based generation, and multi-turn editing, allowing users to refine images through conversational instructions. With support for up to 4K output and flexible image dimensions, it offers a versatile tool for creating and refining visual content.

Flux 3 Image Klein
FLUX 3 Image Klein is a compact, open-weight image generation and editing model developed by Black Forest Labs. It combines text-to-image creation, image editing, and composition using up to 10 reference images in a single model. With support for up to 4K resolution and bounding-box layout control, it gives creators flexible tools to bring their ideas to life.

Mai Image 2.6
MAI-Image-2.6 is Microsoft's image model for text-to-image, single-image editing and composition with up to 5 reference images. It is available in high-quality and Flash versions, with 1K and 2K output and sharp text rendering.

Mai Image 2.6 Flash
MAI-Image-2.6 Flash is the Flash version of Microsoft MAI-Image-2.6 for text-to-image and image editing with up to 5 references, 1K/2K PNG output and optional Bing grounding, billed by actual token usage.