SaaS API가이드라인 V4
항목 1개 추가 (Step 4)
가이드라인에 특정 itemType 의 항목 1개를 추가 생성합니다.
항목 1개 추가
기존 가이드라인에 항목 1개를 추가 생성합니다. SHOT/HOOK 타입의 경우 remaining_shot_codes 가 함께 갱신됩니다. 세션 status 가 EDITING 으로 전이됩니다.
HTTP 요청
POST /ai/guideline/v4/{collabNo}/add-item
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
{
"itemType": "SHOT",
"section": "middle",
"userInstruction": "야외 컷 추가",
"additionalImageUrls": [],
"additionalReferenceLinks": []
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
itemType | String | 예 | 기본값 SHOT. HOOK, REQUIRED_APPEAL, 등 가능 |
section | String | 조건부 | SHOT / HOOK 타입일 때 섹션 이름 (예: beginning, middle, ending) |
userInstruction | String | 아니오 | 사용자 지시 |
additionalImageUrls | Array<String> | 아니오 | 참고 이미지 |
additionalReferenceLinks | Array<String> | 아니오 | 참고 링크 |
샷 추가 정책
SHOT / HOOK 추가는 기존 가이드라인의 remaining_shot_codes 안에서만 새 항목을 생성합니다. 후보에 없는 샷 코드는 새로 만들지 않으며, 추가된 코드는 remaining_shot_codes에서 제거됩니다.
optionType은 촬영 후보 메타데이터를 기준으로 내려갑니다.basicShots후보는BASIC,additionalOptions후보는ADDITIONAL입니다.- HOOK/CTA 계열 항목은
BASIC입니다. - 생성 응답에는
price_tag를 내려주지 않습니다. - 남은 샷 코드가 없으면 추가할 수 없습니다.
응답
성공 응답 (200 OK)
SHOT/HOOK 추가 시:
{
"status": 200,
"code": null,
"message": "항목 추가 완료",
"data": {
"new_item": {
"code": "COLOR_SHOT",
"scene": "제품 컬러가 자연광에서 잘 보이도록 발색을 보여주는 장면",
"example_comment": "실제 컬러는 이런 느낌에 가까워요.",
"reference_url": null,
"optionType": "BASIC"
},
"remaining_shot_codes": ["USAGE_SHOT", "TIP_SHOT", "ETC", "PROCEDURE", "OUTDOOR"]
}
}REQUIRED_APPEAL / OPTIONAL_APPEAL / HASHTAG 추가 시:
{
"status": 200,
"code": null,
"message": "항목 추가 완료",
"data": {
"new_item": "새로운 항목 텍스트",
"remaining_shot_codes": null
}
}data 필드 설명
| 필드 | 타입 | 설명 |
|---|---|---|
new_item | ShotItem | String | 추가된 항목. SHOT/HOOK이면 ShotItem 객체, 나머지는 문자열 |
remaining_shot_codes | Array<String> | null | SHOT 추가 시 남은 장면 코드. 비-장면 항목이면 null |