메인 콘텐츠로 건너뛰기
POST
Image editing: edit reference images (1–5)
오른쪽의 대화형 플레이그라운드는 로컬 이미지 업로드를 지원합니다. Authorization에 API 키를 입력하고(형식: Bearer sk-xxx), 하나 이상의 image 파일을 선택한 다음 prompt 및 model을 입력하고 전송합니다.
🔴 이 엔드포인트는 multipart/form-data 파일 업로드만 허용합니다image을 URL, 데이터 URI 또는 원시 base64로 지정하여 /v1/images/edits에 JSON을 전송하면 400이 반환됩니다.
이미지 URL은 입력으로 지원되지 않습니다. URL만 있는 경우 먼저 서버에서 다운로드한 후 파일을 업로드합니다. 파일 업로드에는 이미지 호스팅이 필요하지 않으며, 로컬 파일을 전송하기만 하면 됩니다.
사용 사례: 이 페이지는 참조 이미지를 사용한 편집을 위한 것으로, 단일 이미지 편집과 1~5개 이미지 융합을 지원합니다. 텍스트만으로 생성하려면 텍스트-이미지 API를 사용합니다.
🖼️ 1~5개의 참조 이미지 지원(2026-10-07부터)
  • 방법: image[] 필드를 이미지 하나당 하나씩 반복합니다. OpenAI SDK에서는 목록을 전달합니다: client.images.edit(image=[f1, f2, ...]). image을 반복해도 작동합니다
  • 순서: 이미지는 업로드 순서대로 번호가 지정되므로(이미지 1, 이미지 2, …), 프롬프트에 이미지 2의 여우를 이미지 1에 넣으라고 지정할 수 있습니다
  • 가격: 요청당 과금되며 이미지 1개와 이미지 5개의 비용은 동일합니다
  • 형식: JPEG, PNG, WebP를 지원하며 GIF 및 기타 형식은 400을 반환합니다
  • 이미지 5개 초과 시 400이 반환됩니다 at most 5 reference images are accepted for <model>
image + image2과 같은 번호가 매겨진 필드 이름은 사용하지 마십시오: 요청은 200을 반환하지만 첫 번째 이미지만 사용되고 두 번째 이미지는 삭제됩니다. image1 + image2은 500을 반환합니다 image is required. 여러 이미지의 경우 항상 image[]을 반복하십시오.
텍스트-이미지와 동일하게 금지된 매개변수: response_format, seed 또는 negative_prompt을 전송하지 마십시오(400). 응답은 항상 data[0].b64_json(PNG)입니다.

코드 예시

Python (OpenAI SDK · 단일 이미지)

Python (OpenAI SDK · 다중 이미지 융합)

Python (requests · 단일 이미지)

여러 이미지의 경우 이미지당 하나의 image[]를 포함하도록 files를 튜플 목록으로 전달합니다(딕셔너리는 동일한 키를 반복해서 포함할 수 없습니다):

cURL

Node.js (fetch + FormData)

매개변수 참조

생략할 때의 출력 크기: 출력은 원본의 종횡비를 따르며 16의 배수로 맞춰집니다. 예를 들어 1344×756 입력은 1360×768이 됩니다. 여러 이미지가 있는 경우 이미지 1이 종횡비를 설정합니다. 구성을 유지해야 하는 로컬 편집에서는 width / height을 전송하지 마십시오.

편집 결과 및 프롬프트 작성

편집 엔드포인트는 원본의 구도, 색상 및 세부 사항을 유지하고 프롬프트에서 요청한 부분만 변경합니다.
MAI-Image-2.6-Flash 편집 예시: 주전자의 색상을 크림색에서 코발트 블루로 변경하고 나머지는 모두 그대로 유지
“나머지는 모두 동일하게 유지”라고 명시적으로 말하는 것이 이 모델에서 가장 효과적인 기법이며, 원본을 최대한 보존합니다.

다중 이미지 융합

이미지 1이 기본 이미지로 사용되며, 다른 참조 이미지의 객체는 프롬프트에 설명된 대로 이미지 1에 배치됩니다. 아래 예시에서는 하나의 요청에 5개의 이미지(차 세트 + 여우 + 고무 오리 + 알람 시계 + 선인장)를 전송하고, 이미지 2의 여우, 이미지 3의 노란색 고무 오리, 이미지 4의 빨간색 빈티지 알람 시계 및 이미지 5의 화분에 심긴 선인장을 이미지 1의 차 테이블 위에 배치하되 각 객체의 외형을 유지하고 이미지 1의 나머지 부분은 변경하지 않도록 요청합니다.
MAI-Image-2.6-Flash 다중 이미지 융합 예시: 5개의 참조 이미지를 입력하고, 네 객체를 모두 차 세트 이미지에 배치하며 나머지는 그대로 유지

응답 형식

응답 필드
  • b64_json는 data: 접두사가 없는 일반 base64이며 PNG로 디코딩됩니다.
  • n > 1를 사용하면 data 배열에 여러 항목이 포함됩니다. data[0]만 읽지 마십시오.
  • url 및 revised_prompt은 반환되지 않습니다.
usage로 과금을 조정하지 마십시오. 여기에는 플레이스홀더가 포함되어 있으며(prompt_tokens은 항상 이미지 수의 1000배입니다), 편집 비용은 텍스트-이미지와 동일하고 이미지당 과금되며 참조 이미지 수는 가격을 변경하지 않습니다. APIYI 콘솔 청구서가 최종 기준입니다.

인증

Authorization
string
header
필수

API key from the APIYI console

본문

multipart/form-data
model
enum<string>
기본값:MAI-Image-2.6-Flash
필수

Model ID (case-sensitive)

사용 가능한 옵션:
MAI-Image-2.6-Flash,
MAI-Image-2.6
prompt
string
필수

Edit instruction. State what to change and that everything else stays the same

예시:

"Change the teapot to a deep cobalt blue glaze, keep everything else identical"

image
file[]
필수

Reference image files, 1–5, numbered image 1…N in upload order. png / jpg / webp. In code, repeat the image[] field for several images

Required array length: 1 - 5 elements
width
integer

Optional output width. Same rules as text-to-image: each side ≥ 768, width × height ≤ 2,359,296, sent together with height

필수 범위: x >= 768
height
integer

Optional output height, same rules as width

필수 범위: x >= 768
n
integer
기본값:1

Number of images. Works on this endpoint, billed per image

필수 범위: x >= 1
예시:

1

응답

Image generated

created
integer

Creation timestamp

예시:

1791000788

data
object[]

Image results; length equals n

usage
object

Placeholder values, not for billing reconciliation. prompt_tokens is always 1000 × images