Skip to main content
POST

인증 및 요청 헤더

string
필수
생성 및 작업 조회 엔드포인트는 플랫폼 API Key를 이용한 Bearer Token 인증을 사용합니다. API Key 관리 페이지에서 키를 발급받으세요.
작업을 조회할 때는 동일한 플랫폼 사용자에게 속한 API Key를 사용하세요.
string
필수
제출 시 application/json을 사용합니다. 텍스트 기반 생성과 참조 이미지 기반 생성 모두 JSON 요청 본문을 전송합니다.

버전 선택

요청 매개변수

string
필수
고정값: gpt-image-2.5-ext.
string
기본값:"flare"
모델 버전입니다. flare, sunburst 중에서 선택합니다.
string
필수
이미지 생성 또는 편집에 사용할 프롬프트입니다. 앞뒤 공백을 제거한 후에도 내용이 있어야 합니다.참조 이미지 기반 생성에서는 유지할 내용과 변경할 내용을 설명할 수 있습니다.
string
기본값:"1K"
출력 해상도 등급입니다. 1K, 2K, 4K 중에서 선택합니다.
string
기본값:"auto"
출력 화면 비율입니다. auto 또는 아래 10가지 비율 중에서 선택합니다.1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.
integer
기본값:"1"
요청당 생성할 이미지 수입니다. 1~4 사이의 정수여야 합니다.
string[]
최대 16개의 참조 이미지 배열입니다. 참조 이미지를 생략하면 텍스트 기반으로 생성하고, 포함하면 참조 이미지 기반으로 생성합니다. 참조 이미지에는 추가 요금이 부과되지 않습니다.지원하는 입력 형식:
  • 접근 가능한 이미지 URL
  • Data URL: data:image/...;base64,...

사용 예제

다음은 POST /v1/images/generations의 JSON 요청 본문입니다. 인증 및 권장 헤더는 위 설명을 따릅니다. 참조 이미지 예제 URL을 실제 접근 가능한 이미지 URL로 바꾸세요.

텍스트 기반 이미지 생성

Sunburst로 참조 이미지 기반 생성

여러 참조 이미지 및 여러 이미지 출력

자동 화면 비율 및 4K 해상도

작업 결과 조회

작업 ID를 사용해 작업 조회 엔드포인트를 호출합니다.

작업 성공

아래 작업 ID, 시간, URL 및 금액은 응답 구조를 설명하기 위한 예시이며 실제 작업이나 가격을 나타내지 않습니다.

응답

integer
응답 상태 코드입니다. 통합 형식의 제출 성공 시 200입니다.
string
문제 해결에 사용하는 이 요청의 식별자입니다.
object
접수된 비동기 작업입니다.