1. 프롬프트 기반 이미지 생성 및 저장

기능 개요

• 사용자가 입력한 prompt를 기반으로 이미지를 생성하고, 생성된 이미지를 Storage Service에 저장후 해당 결과 이미지를 사용자에게 반환하는 기능

• Storage Service 는 대표적으로 AWS S3, FireBase의 firestore 등등이 있다.

주요 기능 구성

• 이미지 저장 => Supabase Storage 에 이미지 파일 업로드

• URL 생성 -> Storage Service의 경우 Public URL 또는 Signed URL을 생성하여 사용자에게 전달

• 인터페이스

  • 입력창 입력 텍스트가 길어지면 위 또는 아래로 늘릴수 있게 하기

보안 및 접근 제어

• private + signed URL 로 권힌 제어
• RLS 정책 추가해서 본인 사진만 조회할수 있도록 하기

예외처리 시나리오

❗ 예외 처리 시나리오 (HTTP 상태 코드 기준)

프롬프트 기반 이미지 생성 및 저장 기능에서 발생할 수 있는 주요 에러 케이스를 정리한 표입니다.

---

🧾 HTTP 상태 코드별 에러 목록

HTTP 상태 코드	상황	설명	응답 예시
400 Bad Request	✅ 필수 파라미터 누락	prompt가 없거나 잘못된 형식일 때	{ "error": "Prompt is required." }
400 Bad Request	이미지 포맷 오류	응답 받은 이미지가 null, 빈 데이터 등 유효하지 않을 때	{ "error": "Generated image is invalid." }
401 Unauthorized	JWT 누락 또는 만료	인증 없이 요청한 경우	{ "error": "Unauthorized request." }
403 Forbidden	RLS 또는 Storage 권한 오류	사용자가 해당 리소스를 저장하거나 조회할 권한이 없는 경우	{ "error": "Access denied." }
404 Not Found	이미지 경로 없음	Supabase Storage에 업로드된 파일 경로가 잘못되었거나 사라진 경우	{ "error": "Image not found." }
429 Too Many Requests	요청 초과	사용자 제한 초과 또는 API rate limit 도달	{ "error": "Too many requests. Try again later." }
500 Internal Server Error	모델 API 에러	이미지 생성 API(OpenAI 등) 호출 실패	{ "error": "Image generation failed. Please try again." }
500 Internal Server Error	Supabase 업로드 실패	파일 저장 중 내부 오류 발생	{ "error": "Failed to upload image." }
503 Service Unavailable	외부 API 장애	이미지 생성 API 또는 Supabase 서비스 불안정	{ "error": "Service temporarily unavailable." }

---

• 📌 공통 에러 응답 형식 예시

{
  "error": "설명 메시지",
  "status": 400,
  "timestamp": "2025-07-09T01:20:00+09:00"
}

ERD