이미지 편집

하나 이상의 입력 이미지와 텍스트 프롬프트에 따라 편집 결과를 생성합니다. 마스크로 수정할 영역을 지정할 수도 있습니다.

POST/v1/images/edits

하나 이상의 입력 이미지와 텍스트 프롬프트에 따라 편집된 이미지를 생성합니다. 마스크를 제공하면 투명 영역이 편집할 위치를 나타냅니다. 여러 이미지를 편집할 때 마스크는 첫 번째 입력 이미지에 적용됩니다.

입력 파일 유형, 크기, 개수, 마스크 규칙 및 품질과 크기 옵션은 선택한 모델에 따라 다릅니다. 현재 API 키에 표시되며 이미지 편집을 지원하는 모델 ID를 사용하세요.

인증

bearerAuth

인증Bearer <token>

Authorization Header에 Bearer your-api-key를 사용합니다.

전달 위치: header

요청 본문

multipart/form-data

Multipart로 이미지, 프롬프트 및 선택적 마스크를 제출합니다. 클라이언트는 요청 라이브러리가 Content-Type의 boundary를 자동 생성하도록 해야 합니다.

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

image*|array<>

편집할 하나 이상의 이미지입니다. DALL·E 2는 4 MB 미만의 정사각형 PNG를 허용하며 mask를 제공하지 않으면 이미지에 투명 영역이 있어야 합니다. GPT-Image-1은 각각 25 MB 미만의 PNG, WEBP 또는 JPG 이미지를 여러 장 허용합니다.

실제로 지원하는 파일 형식, 크기 및 개수는 선택한 모델을 따릅니다.

prompt*string

원하는 편집 결과입니다. DALL·E 2는 최대 1,000자, GPT-Image-1은 최대 32,000자를 허용합니다. 다른 모델의 제한은 실제 기능에 따라 다릅니다.

길이1 <= length

mask?file

선택적 마스크 이미지입니다. 완전히 투명한 영역이 편집할 위치를 나타냅니다. 마스크는 4 MB 미만의 PNG이며 입력 이미지와 크기가 같아야 합니다. 여러 이미지 편집 시 첫 번째 이미지에 적용됩니다.

형식binary

model*string

사용할 이미지 편집 모델 ID입니다. 현재 API 키에 표시되며 이미지 편집을 지원하는 모델을 선택하세요.

길이1 <= length

n?integer|null

반환할 이미지 수이며 범위는 1~10입니다. 실제 지원 개수는 선택한 모델에 따라 다릅니다.

범위1 <= value <= 10

기본값1

quality?string|null

이미지 품질입니다. GPT-Image-1은 high, medium, low를 지원하고 DALL·E 2는 standard를 사용합니다. 기본값은 auto입니다.

기본값"auto"

허용 값

"auto"
"high"
"medium"
"low"
"standard"
null

response_format?string|null

이미지 응답 형식입니다. url은 생성 후 60분 동안 유효한 이미지 주소를 반환하고 b64_json은 Base64로 인코딩된 이미지 데이터를 반환합니다.

기본값"url"

허용 값

"url"
"b64_json"
null

size?string|null

이미지 크기입니다. GPT-Image-1은 1024x1024, 1536x1024, 1024x1536 및 auto를 지원하고 DALL·E 2는 256x256, 512x512, 1024x1024를 지원합니다.

기본값"1024x1024"

허용 값

"256x256"
"512x512"
"1024x1024"
"1536x1024"
"1024x1536"
"auto"
null

user?string

최종 사용자를 나타내는 고유 식별자이며 모니터링 및 오용 감지에 사용할 수 있습니다.

길이1 <= length

응답 본문

`application/json`

curl -X POST "https://example.com/v1/images/edits" \
  -F model="MODEL_ID" \
  -F image="otter.png" \
  -F mask="mask.png" \
  -F prompt="베레모를 쓴 귀여운 아기 해달" \
  -F n="1" \
  -F size="1024x1024"

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://example.com/edited-image-1.png"
    },
    {
      "url": "https://example.com/edited-image-2.png"
    }
  ]
}

인증

요청 본문

응답 본문

200application/json

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`

`application/json`