이 페이지는 Legacy API 문서입니다. 현재 API Gateway의 새 문서로 통합·이전될 예정이며, 신규 통합에는 API Gateway 사용을 권장합니다.
오픈AI 이미지 편집
오픈AI의 이미지 편집 API는 사용자가 제공한 이미지와 텍스트 프롬프트를 기반으로
이미지를 수정하거나 확장할 수 있습니다.
gpt-image-1 모델에서
사용 가능하며, 수정할 영역을 정의할 수 있는 마스크 이미지 속성을 사용하거나,
투명 배경·고화질·다양한 크기 설정 등 세부 제어도 지원합니다. 기존 이미지의
일부를 자연스럽게 바꾸거나 새 이미지를 덧붙이는 데 적합합니다.- SDK: 오픈AI-python GitHub 링크
- 공식 문서: Image API 공식 문서
| API | 지원 모델 |
|---|---|
| openai/images/edit | gpt-image-1 |
이미지 수정
POST
/v1/api/openai/images/edit오픈AI의 이미지 편집 API는 사용자가 업로드한 이미지를 기반으로 프롬프트에 따라 이미지를 수정하거나 확장합니다.
gpt-image-1 모델이 지원되며, 마스크 이미지로 편집 범위를 지정할 수 있습니다. 이 API는 복수 이미지 입력, 투명 배경 설정, 고해상도 출력 등 다양한 편집 옵션을 제공합니다.요청 헤더
파라미터
image
string or array
required
편집할 이미지 또는 이미지 배열.
gpt-image-1:png,webp,jpg형식, 25MB 이하, 최대 16개
prompt
string
required
편집 결과를 설명하는 텍스트 프롬프트.
- 최대 길이:
32000자(gpt-image-1)
model
string
사용할 이미지 모델 :
gpt-image-1 n
integer
생성할 이미지 수 (1~10, 기본값:
1) size
string
이미지 크기 설정 :
gpt-image-1:1024x1024,1536x1024,1024x1536,auto
마지막 수정 날짜: May 02, 2025
요청 예시
curl -X POST "https://factchat-cloud.mindlogic.ai/v1/api/openai/images/edits" \
-H "Authorization: Bearer $YOUR_API_KEY" \
-F "model=gpt-image-1" \
-F "image[]=@body-lotion.png" \
-F "image[]=@bath-bomb.png" \
-F "image[]=@incense-kit.png" \
-F "image[]=@soap.png" \
-F 'prompt=Create a lovely gift basket with these four items in it' \
-o gift-basket.png응답 예시
{
"created": 1713833628,
"data": [
{
"b64_json": "/9j/4SkRgBA...",
"revised_prompt": null,
"url": null
}
],
"usage": {
"total_tokens": 100,
"input_tokens": 50,
"output_tokens": 50,
"input_tokens_details": {
"text_tokens": 10,
"image_tokens": 40
}
}
}