GPT Image 2 · 이미지 생성

POST/v1/images/generations

요청 파라미터

Authorization

Header에 Authorization을 추가하고 값은 Bearer 뒤에 API 키를 붙입니다.

Authorization: Bearer ****************

Header 파라미터

Content-Typestring선택

application/json

Acceptstring선택

application/json

Body 파라미터application/json필수

modelstring필수

모델 ID, `gpt-image-2` 로 고정

promptstring필수

이미지 설명

ninteger선택

생성 장수, 기본값 `1`

sizestring선택

해상도, 예 `1024x1024`

qualitystring선택

품질 등급(모델이 지원할 때)

response_formatstring선택

반환 형식. `url`은 지원하는 모델(예: DALL-E)에만 적용됩니다. OpenAI gpt-image는 항상 `b64_json`을 반환하고 이 필드를 무시합니다.

output_formatstring선택

출력 이미지 인코딩 형식(png / jpeg / webp); OpenAI gpt-image 모델에 적용.

output_compressioninteger선택

압축 레벨 0–100; jpeg / webp에만 적용.

backgroundstring선택

배경 유형(transparent / opaque / auto); transparent는 png 또는 webp 필요.

moderationstring선택

모더레이션 강도(auto / low); 업스트림에서도 검수함.

userstring선택

남용 탐지를 위해 업스트림으로 전달되는 선택적 최종 사용자 식별자.

예시

{
  "model": "gpt-image-2",
  "prompt": "눈밭을 달리는 골든리트리버",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}

{  "model": "gpt-image-2",  "prompt": "눈밭을 달리는 골든리트리버",  "n": 1,  "size": "1024x1024",  "response_format": "b64_json"}

요청 코드 예시

curl https://api.hotrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "눈밭을 달리는 골든리트리버",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

curl https://api.hotrouter.ai/v1/images/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "눈밭을 달리는 골든리트리버",    "n": 1,    "size": "1024x1024",    "response_format": "b64_json"  }'

응답

200 · 성공

createdinteger선택

생성 타임스탬프(초)

dataarray[object]필수

생성된 이미지

예시

{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}

{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

GPT Image 2 · 이미지 생성

요청 파라미터

요청 코드 예시

응답

On this page