SaaS API콘텐츠 가이드라인 API
GET /ai/guideline/guideline/templates/options
촬영/마케팅 옵션 조회
촬영/마케팅 옵션 조회
플랫폼, 콘텐츠 타입, 카테고리에 맞는 촬영 옵션과 마케팅 옵션을 조회합니다.
이 API는 인증이 필요하지 않습니다. 카테고리에 따라 촬영 옵션이 다르므로, 사용자가 카테고리를 선택한 후 해당 옵션을 조회할 때 사용됩니다.
| 항목 | 값 |
|---|---|
| 메서드 | GET |
| 경로 | /ai/guideline/guideline/templates/options |
| 인증 | 불필요 |
요청
GET /ai/guideline/guideline/templates/options?platformCode=INSTAGRAM&contentTypeCode=REEL&categoryCode=BEAUTY HTTP/1.1
Host: api.glowb.comcurl -X GET "https://api.glowb.com/ai/guideline/guideline/templates/options?platformCode=INSTAGRAM&contentTypeCode=REEL&categoryCode=BEAUTY"const params = new URLSearchParams({
platformCode: 'INSTAGRAM',
contentTypeCode: 'REEL',
categoryCode: 'BEAUTY'
});
const response = await fetch(`/ai/guideline/guideline/templates/options?${params}`);
const result = await response.json();Query Parameters
Prop
Type
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "옵션 조회가 완료되었습니다.",
"data": {
"platformCode": "INSTAGRAM",
"contentTypeCode": "REEL",
"categoryCode": "BEAUTY",
"shootingOptions": {
"basicShots": [
{
"code": "TEXTURE_SHOT",
"name": "제형 표현",
"description": "제품의 제형과 텍스처를 보여주는 샷",
"hasAppealPoint": true,
"subOptions": []
},
{
"code": "COLOR_SHOT",
"name": "발색",
"description": "무보정 발색을 보여주는 샷",
"hasAppealPoint": true,
"subOptions": []
},
{
"code": "PACKAGE_SHOT",
"name": "패키지",
"description": "제품 패키지를 보여주는 샷",
"hasAppealPoint": false,
"subOptions": []
},
{
"code": "USAGE_SHOT",
"name": "제품 사용",
"description": "실제 제품을 사용하는 모습",
"hasAppealPoint": true,
"subOptions": [
{
"code": "BODY_EXPOSURE",
"name": "얼굴 외 신체부위 노출",
"additionalPrice": 50000
}
]
},
{
"code": "TIP_SHOT",
"name": "사용 꿀팁",
"description": "제품 사용 팁을 보여주는 샷",
"hasAppealPoint": true,
"subOptions": []
},
{
"code": "ETC",
"name": "기타",
"description": "기타 촬영 요청",
"hasAppealPoint": true,
"subOptions": []
}
],
"additionalOptions": [
{
"code": "NARRATION",
"name": "나레이션 삽입",
"description": "영상에 나레이션을 추가",
"additionalPrice": 20000
},
{
"code": "BEFORE_AFTER",
"name": "비포&애프터 샷",
"description": "사용 전/후 비교 샷",
"additionalPrice": 50000
},
{
"code": "PROCEDURE",
"name": "시술 관련 샷",
"description": "시술 과정이 포함된 촬영",
"additionalPrice": 150000
},
{
"code": "OUTDOOR",
"name": "야외/방문 촬영",
"description": "스튜디오 외 야외 또는 특정 장소 방문 촬영",
"additionalPrice": 30000
},
{
"code": "BODY_EXPOSURE",
"name": "얼굴 외 신체부위 노출",
"description": "얼굴 외 신체부위가 노출되는 촬영",
"additionalPrice": 50000
}
]
},
"marketingOptions": {
"promotionEnabled": true,
"brandAccountTagEnabled": true,
"sponsorLabelEnabled": true,
"collaboratorEnabled": true,
"autoDmEnabled": true,
"autoDmPrice": 50000,
"hashtagMaxCount": 3,
"tagMethods": [
{ "code": "PERSON_TAG", "name": "사람 태그" },
{ "code": "CAPTION_TAG", "name": "캡션에 작성하여 태그" }
]
}
}
}응답 필드 상세
최상위 필드
Prop
Type
shootingOptions (촬영 옵션)
Prop
Type
BasicShotTemplate 객체:
| 필드 | 타입 | 설명 |
|---|---|---|
code | string | 촬영 옵션 코드 |
name | string | 촬영 옵션명 |
description | string | 촬영 옵션 설명 |
hasAppealPoint | boolean | 어필 포인트 입력 가능 여부 |
subOptions | array<SubOptionTemplate> | 서브 옵션 목록 |
SubOptionTemplate 객체:
| 필드 | 타입 | 설명 |
|---|---|---|
code | string | 서브 옵션 코드 |
name | string | 서브 옵션명 |
additionalPrice | integer | 추가 단가 (원) |
AdditionalOptionTemplate 객체:
| 필드 | 타입 | 설명 |
|---|---|---|
code | string | 추가 옵션 코드 |
name | string | 추가 옵션명 |
description | string | 추가 옵션 설명 |
additionalPrice | integer | 추가 단가 (원) |
marketingOptions (마케팅 옵션)
Prop
Type
카테고리별 촬영 옵션
카테고리에 따라 제공되는 촬영 옵션이 다릅니다:
| 카테고리 | 기본 촬영 옵션 |
|---|---|
| 뷰티 | 제형 표현, 발색, 패키지, 제품 사용, 사용 꿀팁, 기타 |
| 패션 | 소재, 언박싱, 착용 방법/꿀팁, 룩북식 코디 |
| 여행 | 상품 소개, 숙소, 음식/맛집, 액티비티, 랜드마크 |
| 금융/비즈니스 | 상품 소개, 사용 가이드, 카피라이팅, 꿀팁 |
| 맛집/요리 | 매장, 요리/서빙, 테이블 연출, 꿀팁, 메뉴/맛 설명 |
| IT | 핵심 기능 시연, 서비스 화면, 사용 장면, 상품 설명 |
| 운동/건강 | 핵심 성분/기능, 패키지, 제품 사용, 루틴 |
| 육아/결혼 | 상품 소개, 강점 강조, 패키지, 꿀팁 |
| 인테리어 | 상품 소개, 다각도, 강점 강조, 패키지, 전경 |
사용 예시
# 인스타그램 릴스, 뷰티 카테고리 옵션 조회
curl -X GET "https://api.glowb.io/ai/guideline/guideline/templates/options?platformCode=INSTAGRAM&contentTypeCode=REEL&categoryCode=BEAUTY"
# 유튜브 쇼츠, 패션 카테고리 옵션 조회
curl -X GET "https://api.glowb.io/ai/guideline/guideline/templates/options?platformCode=YOUTUBE&contentTypeCode=SHORTS&categoryCode=FASHION"
# 블로그, 맛집 카테고리 옵션 조회
curl -X GET "https://api.glowb.io/ai/guideline/guideline/templates/options?platformCode=BLOG&contentTypeCode=POST&categoryCode=RESTAURANT"