← 문서 목록

POST /v1/images/edits

이미지 편집(인페인팅·아웃페인팅). multipart 와 JSON(base64) 모두 지원.

이미지 편집. 공식 OpenAI SDK 의 multipart/form-data 업로드와 JSON 본문(base64 문자열) 양쪽 모두 받습니다.

Parameters

ParameterTypeRequiredDescription
modelstringYes편집을 지원하는 모델 ID
promptstringYes1~4000자
imagestring | fileYes원본 이미지 — JSON 이면 base64 문자열, multipart 면 파일 파트
maskstring | fileNo편집 영역 마스크
nintegerNo생성할 이미지 수 1~4 (기본 1)
sizestringNo256x256 · 512x512 · 1024x1024(기본)
response_formatstringNourl(기본) · b64_json
userstringNo최종 사용자 식별자

요청 본문이 5MB 를 넘으면 413 을 반환합니다. 이미지를 1024px 이하로 리사이즈해서 보내세요.

Request (JSON)

{
  "model": "<편집 지원 모델 ID>",
  "prompt": "change the sky to sunset",
  "image": "<base64-encoded-image>",
  "n": 1
}

Response

{
  "created": 1709884800,
  "data": [
    { "url": "https://..." }
  ]
}