Skip to main content
POST

Authorizations

string
필수
모든 엔드포인트는 Bearer Token 인증이 필요합니다API 키 받기:API 키 관리 페이지 에서 API 키를 받으세요사용 시 요청 헤더에 추가:

Body

string
기본값:"gpt-image-2-official"
필수
이미지 생성 모델 이름gpt-image-2-official 로 고정 (OpenAI 공식 gpt-image-2 모델)
string
필수
이미지 생성을 위한 텍스트 설명
  • 한국어 / 영어 / 중국어 지원, 상세한 설명을 권장
  • 제출 전에 플랫폼의 민감어 / 안전 심사를 거칩니다. 위반 내용은 즉시 오류를 반환합니다
string
기본값:"1:1"
이미지 비율외부에서는 비율 값을 사용하며, 시스템 내부에서는 resolution 에 따라 실제 픽셀로 자동 매핑됩니다.다음 비율 지원, 추가로 auto 를 전달하면 서버에서 적절한 비율을 자동 선택합니다:
  • auto - 자동 (prompt / 참조 이미지에 따라 서버가 비율을 선택)
  • 1:1 - 정사각형 (기본값, SNS 아바타 / 로고)
  • 3:2 - 가로 구도 (DSLR 카메라 일반 비율)
  • 2:3 - 세로 구도 (포스터 세로판)
  • 4:3 - 가로 구도 (클래식 모니터 / 슬라이드)
  • 3:4 - 세로 구도
  • 5:4 - 가로 구도
  • 4:5 - 세로 구도 (Instagram 세로판 게시물)
  • 16:9 - 가로 구도 (와이드 비디오 커버)
  • 9:16 - 세로 구도 (폰 풀스크린 / 숏 비디오 커버)
  • 2:1 - 가로 구도 (웹 배너)
  • 1:2 - 세로 구도
  • 3:1 - 가로 구도 (초광각 배너)
  • 1:3 - 세로 구도 (초장형 포스터)
  • 21:9 - 가로 구도 (영화 울트라와이드)
  • 9:21 - 세로 구도
1881x836 / 887x1774 같은 픽셀 크기도 직접 전달할 수 있습니다.
sizeauto 를 전달하면 기본 비율은 1:1 입니다.
string
기본값:"1k"
해상도 등급 (신규 필드)실제 출력 해상도를 제어합니다.
  • 1k - 1024 기준, 일상 사용에 비용 효율적 (기본값)
  • 2k - 2048 기준, 포스터 / 고해상도 용도에 적합
  • 4k - 3840 기준, 아래 매핑 표의 15가지 비율 지원
4K 는 아래 매핑 표의 15가지 비율을 지원합니다. 표의 픽셀 크기를 size 로 직접 전달할 수도 있습니다.
string
기본값:"auto"
이미지 품질
  • auto - 자동 (기본값, 보통 low 와 동일)
  • low - 빠르고 저렴, 윤곽 정도
  • medium - 균형형
  • high - 최고 정밀도 (4K + high 는 120 초 이상 소요 가능)
string
기본값:"auto"
배경 모드
  • auto - 자동 (기본값)
  • opaque - 불투명
  • transparent - ⚠️ gpt-image-2-official 은 투명 배경을 지원하지 않으며, 전달해도 시스템이 자동으로 auto 로 강등합니다
string
기본값:"auto"
모더레이션 강도
  • auto - 기본 모더레이션 강도
  • low - 보다 완화된 모더레이션
string
기본값:"png"
출력 포맷
  • png - 기본값
  • jpeg - 파일 크기가 작음
  • webp - 최신 브라우저에 최적
integer
출력 압축 강도, 범위 0-100
  • jpeg / webp 에만 유효
integer
기본값:"1"
생성할 이미지 장수범위:1 ~ 4
반드시 순수 숫자 (예: 1) 를 입력하세요. 따옴표로 감싸지 마세요
array
참조 이미지 URL 배열
string
마스크 이미지 URL, 로컬 리터치 (inpainting) 용도
  • image_urls 와 함께 사용해야 합니다
  1. 마스크 이미지를 업로드하기 전에 Alpha 채널이「예」인지 확인하세요.
  2. 마스크 이미지 크기는 첫 번째 참조 이미지와 일치 해야 합니다.

사이즈 × 해상도 매핑 표

size × resolution → OpenAI 실제 픽셀 (15 비율 × 3 등급):
참고:일부 크기는 16의 배수와 픽셀 상한을 기준으로 근사 매핑됩니다. 예를 들어 3:2 / 2:3 @ 2K 는 2048×1360, 21:9 @ 4K 는 3840×1648 입니다. 실제 픽셀은 표의 값을 기준으로 하세요.

사용 시나리오 예시

텍스트-이미지 (최소 요청)
2K 고해상도 포스터
4K 배경화면
이미지-이미지 (다중 참조 융합)
로컬 리터치 (mask)
다중 생성 (n > 1)
픽셀 문자열 직접 전달 (고급 사용법)

Response

integer
응답 상태 코드
array
응답 데이터 배열

작업 결과 조회

제출 성공 후 task_id 가 반환됩니다. GET /v1/tasks/{task_id} 로 작업 상태를 폴링하세요. 자세한 내용은 작업 조회 API 참조.

성공 응답 예시

usage 필드는 이 요청의 과금 대상 토큰 사용량을 나타냅니다: 이미지 생성에서는 출력이 주로 이미지 토큰이므로 output_tokens_details.image_tokens 는 보통 output_tokens 와 같습니다. 위 예시에서 total_tokens = 22 + 196 = 218 입니다. 작업 상태 흐름:submittedin_progresscompleted / failed. 이미지 가져오기:data.result.images[0].url[0].