Skip to main content
POST

Authorizations

string
필수
모든 엔드포인트는 Bearer Token을 사용하여 인증해야 합니다.API 키 얻기:API Key 관리 페이지에 접속하여 API 키를 받으세요.사용할 때 요청 헤더에 다음을 추가하세요:

Body

string
기본값:"gpt_image_2_official"
필수
이미지 생성 모델 이름gpt_image_2_official (OpenAI 공식 gpt-image-2 모델)로 고정 작성
object
필수
모델 파라미터 객체
string
필수
발신자 작업 ID사용자가 정의하는 작업 식별자, 필수 입력

크기 × 해상도 매핑 표

aspect_ratio × resolution → OpenAI 실제 픽셀(13 비율 × 3 단계):
3:2 / 2:3 @ 2K 실제는 2048×1360(근사 비율, 오차 < 0.5%); 4K는 6개 비율만 지원(전체 픽셀 OpenAI 한도 초과 조합은 사용 불가).

Response

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

작업 결과 조회

제출이 성공하면 task_id가 반환되며, GET /v1/tasks/{task_id}를 통해 작업 상태를 폴링하여 확인할 수 있습니다. 자세한 내용은 작업 조회 API를 참조하세요.

폴링 권장사항

  • 최초 조회 지연: 제출 후 10~20초 대기 후 조회 시작 권장
  • 조회 간격: 3~5초마다 한 번 권장
  • 타임아웃 참고: high + 2K/4K 조합 작업은 최대 130초 소요될 수 있으니 클라이언트 타임아웃을 180초 이상으로 설정 권장