메인 콘텐츠로 건너뛰기
POST
모델명 호환 안내: 이 엔드포인트는 별칭 gpt-image-2-ext도 지원하며, 이는 gpt-image-2와 동일하므로 서로 바꿔 사용할 수 있고 효과도 동일합니다.

Authorizations

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

Body

model
string
기본값:"gpt-image-2"
필수
이미지 생성 모델 이름gpt-image-2 로 고정 (호환 별칭 gpt-image-2-ext 사용 가능)
구버전 호출과의 호환을 위해 별칭 gpt-image-2-ext(gpt-image-2에 해당)는 계속 정상적으로 사용할 수 있습니다.
prompt
string
필수
이미지 생성을 위한 텍스트 설명
  • 한국어 / 영어 / 중국어 지원, 상세한 설명을 권장
  • 제출 전에 플랫폼의 민감어 / 안전 심사를 거칩니다. 위반 내용은 즉시 오류를 반환합니다
n
integer
기본값:"1"
생성할 이미지 장수범위:1 - 10
반드시 순수 숫자(예:1)를 입력하세요. 따옴표로 감싸지 마세요
size
string
기본값:"1:1"
이미지 생성 비율다음 비율 지원, auto 를 전달하면 서버에서 적절한 비율을 자동 선택합니다:1881x836 / 887x1774 같은 픽셀 크기도 직접 전달할 수 있습니다.
sizeauto 를 전달하면 기본 비율은 1:1 입니다.
resolution
string
기본값:"1k"
출력 해상도 단계선택 가능 값:1k / 2k / 4ksize × resolution → 실제 픽셀 매핑:
4K 는 위 15가지 비율을 지원합니다. 표의 픽셀 크기를 size 로 직접 전달할 수도 있습니다.
image_urls
array
참조 이미지 배열 (OpenAI 표준 필드). 전달하면 이미지-이미지 모드로 전환됩니다
기타 OpenAI 표준 필드(response_format, style 등)는 현재 지원되지 않으며 무시됩니다. 작업 결과는 url 만 반환됩니다. base64 가 필요하면 직접 다운로드하여 변환하세요.
official_fallback
boolean
기본값:"false"
공식 채널을 폴백으로 사용할지 여부
  • false:사용 안 함 (기본값)
  • true:공식 채널 사용

사용 시나리오 예시

텍스트-이미지 (최소 요청)
텍스트-이미지 (비율 지정 + 2K)
텍스트-이미지 (4K 출력)
텍스트-이미지 (다중 생성)
이미지-이미지 (참조 = URL)
이미지-이미지 (참조 = base64)
이미지-이미지 (다중 참조 융합, URL + base64 혼합)

Response

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

작업 결과 조회

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

성공 응답 예시

이미지 가져오기:data.result.images[0].url[0]

작업 상태