개발자 리소스

GPT Image 1.5 API 문서

OpenAI의 GPT Image 1.5 모델을 애플리케이션에 통합하세요. 단순한 REST API를 통해 텍스트-투-이미지 및 이미지-투-이미지 생성을 지원합니다.

인증

GPT Image 1.5 API는 Bearer Token 인증을 사용합니다. 요청 헤더에 API 키를 포함하여 전달하세요.

인증

Authorization: Bearer sk-your-api-key-here

API 키를 안전하게 보관하세요. 클라이언트 측 코드에 노출되지 않도록 주의하십시오.

가격 정책

유형	비용	설명
텍스트-투-이미지	10 크레딧	텍스트 프롬프트에서 이미지를 생성합니다.
이미지-투-이미지	10 크레딧	텍스트 프롬프트를 사용하여 기존 이미지를 편집합니다.

작업 생성

POSThttps://gptimage15.ai/api/generate

비동기 생성

가격 정책

텍스트-투-이미지 또는 이미지-투-이미지 여부에 관계없이 각 생성 요청당 10 Credits이 소모됩니다.

생성 작업을 시작합니다. API는 즉시 task_id를 반환하며, 이를 사용하여 결과를 폴링할 수 있습니다.

바디 파라미터

파라미터	유형	필수	설명
prompt	string	필수	이미지 생성을 위한 텍스트 설명입니다. 최대 2000자까지 가능합니다.
size	string	선택	이미지 크기: 10241024, 10241536 또는 15361024. 기본값: 10241024
quality	string	선택	이미지 품질: low, medium 또는 high. 기본값: medium
images	array	선택	이미지-투-이미지 모드용. 편집할 이미지 URL 배열입니다.
input_fidelity	string	선택	입력 이미지에 대한 충실도: low 또는 high. 기본값: high. 이미지-투-이미지 모드에서만 사용됩니다.
callback_url	string	선택	작업 완료 알림을 받을 웹훅(Webhook) URL입니다.

요청 예시

Text-to-Image (cURL)

curl -X POST https://gptimage15.ai/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape...",
    "size": "1536*1024",
    "quality": "high"
  }'

Image-to-Image (Edit Mode)

{
  "prompt": "Add a rainbow in the sky",
  "images": [
    "https://example.com/landscape.jpg"
  ],
  "input_fidelity": "high",
  "quality": "medium"
}

성공 응답

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS"
  }
}

오류 응답

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

상태 확인

GEThttps://gptimage15.ai/api/status

이 엔드포인트를 폴링하여 작업 진행 상황을 확인하세요. 5~10초 간격으로 폴링하는 것을 권장합니다.

쿼리 파라미터

파라미터	유형	설명
task_id	string	생성 엔드포인트에서 받은 작업 ID입니다. 필수

상태 값

PENDING작업 대기 중

IN_PROGRESS처리 중

SUCCESS완료됨

FAILED오류 발생

cURL

curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
  -H "Authorization: Bearer YOUR_API_KEY"

응답 (진행 중)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

응답 (완료됨)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

응답 (실패)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

오류 코드

코드	설명
200	성공
400	잘못된 요청 - 유효하지 않은 파라미터 (프롬프트 누락, 잘못된 크기/품질 등)
401	권한 없음 - API 키가 누락되었거나 유효하지 않음
404	찾을 수 없음 - 해당 작업 ID가 존재하지 않음
500	내부 서버 오류 - 다시 시도하거나 고객 지원에 문의하세요

도움이 필요하신가요?

지원 채널을 확인하거나 이메일로 문의해 주세요.

고객 지원 문의