개발자 리소스
GPT Image 1.5 API 문서
OpenAI의 GPT Image 1.5 모델을 애플리케이션에 통합하세요. 단순한 REST API를 통해 텍스트-투-이미지 및 이미지-투-이미지 생성을 지원합니다.
1
인증
GPT Image 1.5 API는 Bearer Token 인증을 사용합니다. 요청 헤더에 API 키를 포함하여 전달하세요.
인증
Authorization: Bearer sk-your-api-key-here
API 키를 안전하게 보관하세요. 클라이언트 측 코드에 노출되지 않도록 주의하십시오.
가격 정책
| 유형 | 비용 | 설명 |
|---|---|---|
| 텍스트-투-이미지 | 10 크레딧 | 텍스트 프롬프트에서 이미지를 생성합니다. |
| 이미지-투-이미지 | 10 크레딧 | 텍스트 프롬프트를 사용하여 기존 이미지를 편집합니다. |
2
작업 생성
POST
https://gptimage15.ai/api/generate비동기 생성
가격 정책
텍스트-투-이미지 또는 이미지-투-이미지 여부에 관계없이 각 생성 요청당 10 Credits이 소모됩니다.
생성 작업을 시작합니다. API는 즉시 task_id를 반환하며, 이를 사용하여 결과를 폴링할 수 있습니다.
바디 파라미터
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
| prompt | string | 필수 | 이미지 생성을 위한 텍스트 설명입니다. 최대 2000자까지 가능합니다. |
| size | string | 선택 | 이미지 크기: 1024*1024, 1024*1536 또는 1536*1024. 기본값: 1024*1024 |
| 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
}3
상태 확인
GET
https://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 | 내부 서버 오류 - 다시 시도하거나 고객 지원에 문의하세요 |