개별 항목 재생성

생성된 가이드라인의 특정 항목 1개를 다시 생성합니다. 사용자 지시문(userInstruction) + 추가 참고자료를 함께 전달 가능. 세션 status 가 EDITING 으로 전이됩니다.

HTTP 요청

POST /ai/guideline/v4/{collabNo}/regenerate
Authorization: Bearer {access_token}
Content-Type: application/json

Request Body

{
  "itemType": "SHOT",
  "section": "middle",
  "targetIndex": 1,
  "userInstruction": "더 밝게",
  "additionalImageUrls": [],
  "additionalReferenceLinks": []
}

필드	타입	필수	설명
`itemType`	`String`	예	`SHOT`, `HOOK`, `REQUIRED_APPEAL`, `OPTIONAL_APPEAL`, `HASHTAG`, `CONCEPT_ONE_LINER` 등
`section`	`String`	조건부	`SHOT` / `HOOK` 타입일 때 섹션 이름 (예: `beginning`, `middle`, `ending`)
`targetIndex`	`Integer`	예	해당 itemType 배열 내 대상 인덱스
`userInstruction`	`String`	아니오	재생성 시 반영할 사용자 지시
`additionalImageUrls`	`Array<String>`	아니오	추가 이미지 URL
`additionalReferenceLinks`	`Array<String>`	아니오	추가 참고 링크

샷 재생성 정책

SHOT / HOOK 재생성은 대상 항목의 code를 유지하고 scene, example_comment, reference_url 중심으로 내용을 다시 생성합니다.

기존 코드가 촬영 후보에 있으면 해당 후보의 optionType을 유지합니다.
HOOK/CTA는 촬영 후보와 별개로 optionType=BASIC입니다.
재생성은 remaining_shot_codes를 소비하지 않습니다.
생성 응답에는 price_tag를 내려주지 않습니다.

응답

성공 응답 (200 OK)

세션의 해당 위치가 자동 갱신됩니다.

SHOT/HOOK 재생성 시:

{
  "status": 200,
  "code": null,
  "message": "항목 재생성 완료",
  "data": {
    "new_item": {
      "code": "BEFORE_AFTER",
      "scene": "같은 구도에서 사용 전후 차이를 더 밝은 조명으로 비교해 보여주는 장면",
      "example_comment": "조명 아래에서 보니 전후 차이가 더 선명하게 느껴져요.",
      "reference_url": null,
      "optionType": "ADDITIONAL"
    },
    "additional_gemini_file_ids": []
  }
}

REQUIRED_APPEAL / OPTIONAL_APPEAL / HASHTAG / CONCEPT_ONE_LINER 재생성 시:

{
  "status": 200,
  "code": null,
  "message": "항목 재생성 완료",
  "data": {
    "new_item": "새로운 항목 텍스트",
    "additional_gemini_file_ids": []
  }
}

data 필드 설명

필드	타입	설명
`new_item`	`ShotItem \| String`	재생성된 항목. `SHOT`/`HOOK`이면 ShotItem 객체, 나머지는 문자열
`additional_gemini_file_ids`	`Array<String>`	추가 업로드된 Gemini 파일 ID

개별 항목 재생성 (Step 3)

개별 항목 재생성

HTTP 요청

Request Body

샷 재생성 정책

응답

data 필드 설명

API 테스트

On this page