Skip to main content
POST

지원 모델

Authorizations

string
필수
모든 API 요청에는 Bearer Token 인증이 필요합니다API Key 받기:API Key 관리 페이지에서 API Key를 받으세요요청 헤더에 다음을 추가하세요:

Body

string
필수
모델 이름
  • gpt-image-1-official - 안정성 우선, 범용 이미지 생성에 적합
  • gpt-image-1.5-official - 신규 버전, 고품질 및 복잡한 편집에 적합
string
필수
이미지 생성을 위한 텍스트 설명, 중국어와 영어 지원
string
기본값:"1:1"
화면 비율지원 비율:
  • 1:1 - 정사각형 (기본값)
  • 3:2 - 가로형
  • 2:3 - 세로형
integer
기본값:"1"
생성 이미지 수범위: 1-4
  • 0 이하의 값은 1로 처리됩니다
  • 4를 초과하는 값은 4로 처리됩니다
⚠️ 주의: 순수 숫자(예: 1)를 입력해야 합니다. 따옴표를 추가하면 오류가 발생합니다
string
기본값:"auto"
이미지 품질
  • auto - 자동 품질 선택 (기본값)
  • low - 더 빠르고 경제적
  • medium - 품질과 비용의 균형
  • high - 더 높은 품질, 더 높은 비용
string
기본값:"auto"
배경 모드
  • auto - 자동 배경 (기본값)
  • opaque - 불투명 배경
  • transparent - 투명 배경, png 출력 형식과 함께 사용 권장
background: transparentoutput_format: jpeg는 동시에 사용할 수 없습니다
string
기본값:"auto"
검수 강도
  • auto - 기본 검수 강도
  • low - 더 관대한 검수
string
기본값:"png"
출력 형식
  • png - 기본 형식, 투명 배경에 적합
  • jpeg - 파일 크기가 작음, 일반 이미지 출력에 적합
background: transparentoutput_format: jpeg는 동시에 사용할 수 없습니다
integer
출력 압축 수준, 범위 0-100
  • jpeg에서만 사용 권장
  • png에서는 설정 불필요
array
참조 이미지 URL 배열, 제공 시 이미지-이미지 모드가 활성화됩니다제한: 최대 15장의 참조 이미지
string
마스크 이미지 URL, 인페인팅용
  • image_urls와 함께 사용해야 합니다
  • 공식 편집 API를 통해 함께 제출됩니다
1、마스크 이미지를 업로드하기 전에 이미지의 Alpha 채널이 “예”인지 확인하세요.2、마스크 이미지 크기는 첫 번째 참조 이미지와 일치해야 합니다.

크기 참조표

화면 비율은 외부에서 사용되며, 시스템 내부에서 공식 실제 크기로 자동 매핑됩니다.

사용 예시

텍스트-이미지 (최소 요청)
텍스트-이미지 (전체 매개변수)
이미지-이미지 (단일 참조 이미지)
이미지-이미지 (다중 참조 이미지 융합)
다중 생성 (n > 1)

Response

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

주의사항

  1. 비동기 처리: 제출 후 task_id가 반환됩니다. /v1/tasks/{task_id}를 폴링하여 결과를 얻으세요
  2. 모델 선택: 범용 이미지 생성에는 gpt-image-1-official을 우선 사용. 고품질 편집 및 복잡한 이미지-이미지에는 gpt-image-1.5-official 권장
  3. 이미지 URL 요구사항: 이미지-이미지에는 공개적으로 접근 가능한 안정적인 이미지 URL을 사용하세요
  4. 과금 규칙: 성공적으로 생성된 이미지 수에 따라 과금, 실패 시 과금 없음