패션 렌즈
시각 지능 서비스 중이미지 속 패션 아이템(의류, 잡화 등)을 분석하여 브랜드, 소재, 스타일 정보를 제공합니다.
API 키 필수
HTTPS
POST
/api/v1/fashion/lens
API 설명
의류, 가방, 신발 등 패션 아이템 사진 한 장으로 모든 정보를 파악하세요.\nAI가 브랜드, 색상, 질감, 패턴, 소재, 스타일을 상세히 분석하여 데이터로 반환합니다.
사용 가이드
### API 엔드포인트
```http
POST /api/v1/fashion/lens
Content-Type: application/json
X-API-Key: YOUR_API_KEY
```
### 요청 파라미터
| 필드명 | 타입 | 필수 | 설명 |
| :--- | :---: | :---: | :--- |
| base64_image | String | Y | 패션 아이템 이미지의 Base64 문자열 |
### 응답 파라미터
| 필드명 | 타입 | 설명 |
| :--- | :---: | :--- |
| success | Boolean | API 호출 성공 여부 |
| analysis | Object | 패션 상세 분석 데이터 |
| ├── category | String | 아이템 종류 (상의, 드레스, 가방 등) |
| ├── brand | String | 고유 브랜드 정보 (추출 시 표시) |
| ├── color | String | 주요 색상 정보 |
| ├── texture | String | 질감 정보 (부드러움, 거침 등) |
| ├── pattern | String | 무늬/패턴 정보 |
| ├── material | String | 소재 정보 (면, 가죽 등) |
| ├── style | String | 전체적인 스타일 (빈티지, 페미닌 등) |
| └── description | String | AI 분석 상세 코멘트 |
| api | String | 호출된 API 식별값 (fashion-lens) |
| remaining | Integer | 잔여 호출 횟수 |
### 오류 코드
| 코드 | 메시지 | 설명 |
| :--- | :--- | :--- |
| 400 | Bad Request | 이미지 데이터(Base64) 누락 또는 형식 오류 |
| 401 | Unauthorized | API Key 누락 또는 유효하지 않음 |
| 429 | Too Many Requests | 할당된 호출 횟수 초과 |
| 500 | Internal Error | 분석 서버 통신 실패 또는 분석 불가 |
### 응답 예시
```json
{
"success": true,
"analysis": {
"category": "드레스",
"brand": "",
"color": "흰색",
"texture": "부드러움",
"pattern": "",
"material": "면",
"style": "빈티지, 페미닌",
"description": "가슴부분에 리본 디테일이 있으며, 퍼프 소매와 플레어 스커트가 특징인 짧은 길이의 드레스입니다."
},
"api": "fashion-lens",
"remaining": 19
}
```
공통 인증 헤더
X-API-Key: YOUR_API_KEY
Content-Type: application/jsoncURL 예제
curl -X POST https://engines.ai.kr/api/v1/fashion/lens \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"base64_image":"...IMAGE_BASE64_DATA..."}'