개발자 참고 문서

GPT Image 2.6 API 문서

API 키를 만들고 생성 요청을 제출한 다음 작업을 조회해 이미지를 가져오세요.

API 키 만들기

로그인한 후 계정에서 키를 만드세요. 아래 예시를 실행하기 전에 서버 환경의 GPT_IMAGE_API_KEY에 해당 키를 설정하세요.

API 키 관리

키는 서버에 보관하세요. 두 엔드포인트 모두 Authorization: Bearer에 사용자 API 키를 사용하며 브라우저 쿠키가 필요하지 않습니다.

생성 요청에는 계정의 크레딧이 사용됩니다. 설정이 같으면 Flare와 Sunburst의 크레딧 비용도 같습니다. 현재 이미지 비용 확인

이미지 생성 요청 제출

POST /api/generate

아래 JSON을 request.json으로 저장하세요. 이 예시는 텍스트로 이미지를 생성합니다. 참고 이미지로 편집하려면 아래에 설명된 images 배열을 추가하세요.

요청 본문: `request.json`

{
  "model": "gpt-image-2.6",
  "variant": "flare",
  "prompt": "따뜻한 종이 배경 앞 나무 테이블 위에 놓인 파란색 도자기 컵.",
  "quality": "medium",
  "resolution": "1k",
  "complexity": "high",
  "output_format": "png"
}

서버에서 전송

curl --request POST https://gptimage-26.com/api/generate \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --header "Content-Type: application/json" \
  --data @request.json

제출에 성공하면 code 200, data.task_id, IN_PROGRESS로 설정된 data.status, data.consumed_credits가 반환됩니다. 상태 조회를 위해 data.task_id를 저장하세요.

요청 필드

필드	의미 및 허용 값
`model`	gpt-image-2.6을 사용하세요. 생략해도 이 모델이 기본으로 적용됩니다.
`variant`	선택 값: flare, sunburst. 기본값: flare. Sunburst를 사용하려면 sunburst로 설정하세요.
`prompt`	필수 텍스트이며 앞뒤 공백을 제거한 후 1~20000자여야 합니다.
`quality`	선택 값: low, medium, high, xhigh, max. 기본값: medium.
`resolution`	선택 값: 1k, 2k, 4k. 기본값: 1k.
`complexity`	구도 계획의 선택 값: low, medium, high. 기본값: high.
`output_format`	선택 값: png, jpeg, webp. 기본값: png.
`images`	HTTP(S) 이미지 URL을 최대 16개 포함하는 선택적 배열입니다. 참고 이미지를 하나 이상 제공하면 편집 모드가 되며, 텍스트로 생성할 때는 생략하세요.

작업 조회

GET /api/status

반환된 data.task_id를 TASK_ID로 설정하세요. 동일한 사용자 API 키와 함께 task_id 쿼리 매개변수로 전송하세요.

curl --get https://gptimage-26.com/api/status \
  --header "Authorization: Bearer $GPT_IMAGE_API_KEY" \
  --data-urlencode "task_id=$TASK_ID"

PENDING / IN_PROGRESS: 작업이 진행 중입니다. 이 엔드포인트를 다시 조회해 진행 상황을 확인하세요.
SUCCESS: data.response 배열에서 생성된 이미지 URL을 가져오세요.
FAILED: 새 요청을 제출할지 결정하기 전에 data.error_message에서 실패 내용을 확인하세요.

완료된 작업의 예시

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "<TASK_ID>",
    "status": "SUCCESS",
    "response": [
      "<IMAGE_URL>"
    ],
    "error_message": null
  }
}

꺾쇠괄호 안의 값은 요청에서 실제로 반환되는 작업 ID와 이미지 URL을 나타내는 자리표시자입니다.