Skip to main content
POST
Image editing: edit a reference image or fuse two images
오른쪽의 대화형 Playground에서는 로컬 이미지 업로드를 지원합니다. Authorization 아래에 API 키(형식: Bearer sk-xxx)를 입력하고, image 파일을 선택한 후, prompt 및 model 항목을 입력하고 전송하십시오.
🔴 이 엔드포인트는 multipart/form-data 파일 업로드만 허용합니다/v1/images/edits에 JSON을 전송하면(image를 URL, 데이터 URI 또는 원시 base64로 지정) 400 오류가 반환됩니다:
이미지 URL은 입력으로 지원되지 않습니다. URL만 보유하고 있는 경우, 먼저 서버에서 다운로드한 후 해당 파일을 업로드하십시오. 파일 업로드는 이미지 호스팅이 필요하지 않으며, 로컬 파일만 전송하면 됩니다.
사용 사례: 이 페이지는 참조 이미지를 편집하거나 두 이미지를 합성하는 용도입니다. 텍스트로만 생성하려면 텍스트-이미지 API를 사용하십시오.
⚠️ 두 개의 이미지의 경우 필드 이름은 image[]이 아니라 image + image2입니다두 개의 참조 이미지를 사용하는 경우, 첫 번째 필드 이름을 image, 두 번째 필드 이름을 image2(으)로 지정하십시오. image[]를 반복하거나, image를 반복하거나, mask 필드를 추가하면 모두 400 File must be attached in a form field with a name starting with 'image' 오류가 반환됩니다.즉, OpenAI SDK의 다중 이미지 형식 client.images.edit(image=[f1, f2])은 작동하지 않습니다(image[]을(를) 전송함). SDK를 통한 단일 이미지 편집은 정상 작동합니다.
텍스트-이미지와 동일한 금지 파라미터: response_format, seed 또는 negative_prompt를 전송하지 마십시오(400). 응답은 항상 data[0].b64_json(PNG)입니다.

코드 예제

Python (OpenAI SDK · 단일 이미지)

Python (requests · 단일 이미지)

Python (두 이미지 합성 · image + image2)

cURL

Node.js (fetch + FormData)

파라미터 레퍼런스

생략 시 출력 크기: 출력은 16의 배수로 맞춰진 원본의 가로세로 비율을 따릅니다(예: 1344×756 입력 시 1360×768 출력). 구도를 유지해야 하는 부분 편집의 경우 width / height을 전송하지 마십시오.

편집 결과 및 prompt 작성

편집 엔드포인트는 원본의 구도, 색상 및 세부 사항을 유지하며 prompt에서 요청한 부분만 변경합니다:
MAI-Image-2.6-Flash 편집 예시: 크림색 티팟을 코발트 블루로 변경, 다른 모든 요소는 변경되지 않음
두 이미지 합성의 경우, prompt 내에서 image / image2을 “image 1 / image 2”로 지칭하십시오. 테스트 결과 인물에 대한 동일성 재현율은 보통 수준(이목구비 특징이 달라질 수 있음)이므로, 인물 사진의 일관성이 중요하다면 먼저 소량 배치로 검증하십시오.

응답 형식

응답 필드
  • 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 file (the first one, "image 1" in the prompt). png / jpg / webp

image2
file

Optional second reference image ("image 2" in the prompt), for two-image fusion

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