# 이미지 (Images) API

## 엔드포인트 목록

| 메서드 | 경로 | 설명 |
|--------|------|------|
| POST | /openapi/v1/images/upload-url | 이미지 업로드 Presigned URL 발급 |

## POST /openapi/v1/images/upload-url

S3 presigned URL을 발급합니다. 발급된 URL로 이미지를 PUT 업로드한 후, 반환된 `imageId`를 상품 생성 시 사용합니다.

### 요청 본문

| 필드 | 타입 | 필수 | 설명 |
|------|------|------|------|
| workspaceId | string | Y | 워크스페이스 ID |
| extension | string | Y | 파일 확장자 (예: `jpg`, `png`, `webp`) |

### 응답 (200)

```json
{
  "data": {
    "imageId": "img_abc123",
    "uploadUrl": "https://s3.amazonaws.com/...?X-Amz-Signature=..."
  }
}
```

### 사용 플로우

```bash
# 1. Presigned URL 발급
curl -X POST \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"workspaceId": "ws_abc123", "extension": "jpg"}' \
  https://openapi.gency.ai/openapi/v1/images/upload-url

# 2. 이미지 업로드 (PUT)
curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @product-photo.jpg \
  "https://s3.amazonaws.com/...presigned-url..."

# 3. 반환된 imageId를 create_product에서 사용
```

> **참고**: Presigned URL은 1시간 후 만료됩니다.