크리에이터가 제출 전·후 무관하게 본인 스크립트/영상 초안을 AI 자동 검수에 직접 요청

AI 검수 (셀프 요청)

크리에이터가 제출 전·후 무관하게 본인 스크립트 또는 영상 초안을 AI 자동 검수에 직접 요청하는 기능입니다.

개요

수동 요청 전용: 이 기능은 크리에이터가 직접 "AI 검수 받기"를 누를 때만 횟수가 차감됩니다. 일괄 제출 시 자동으로 진행되는 AI 검수는 별개 경로이며 횟수 제한 없음.
비동기 처리: 요청 후 결과는 비동기로 생성됩니다. 스크립트 검수는 평균 30~60초, 영상 검수는 평균 10~15분 소요됩니다.
완료 알림: 검수가 완료되면 Node 서버를 경유하여 푸시 알림이 발송됩니다.
횟수 추가: 소진 시 관리자가 1회씩 추가 부여할 수 있습니다.

콘텐츠 타입	기본 허용 횟수	횟수 카운트 기준
스크립트 (`SCRIPT`)	5회	수동 "AI 검수 받기" 요청 시에만
영상 (`VIDEO`)	5회	수동 "AI 검수 받기" 요청 시에만

상황	횟수 처리
결과 산출 완료 (`PASS` / `FAIL` / `PARTIAL`)	차감
시스템 오류 (AI 모델 에러 등)	환불 (차감 취소)
사전 검증 실패 (작성된 스크립트 없음 / 업로드된 영상 없음 / 잘못된 타입)	미차감 (요청 자체 거부)
입력 처리 불가 (파싱 실패 등)	환불 (차감 취소)

사전 검증 실패는 요청이 거부되어 횟수가 소비되지 않습니다. 시스템 오류 및 입력 처리 불가는 요청은 수락했으나 결과를 생성하지 못한 경우로, 차감된 횟수가 자동 환불됩니다.

메서드	경로	설명
`POST`	`/ai/influence/contents/ai-review/request/script/{reviewId}`	스크립트 AI 검수 요청
`POST`	`/ai/influence/contents/ai-review/request/video/{itemId}`	영상 AI 검수 요청
`GET`	`/ai/influence/contents/ai-review/quota/{applicationId}`	남은 횟수 조회
`GET`	`/ai/influence/contents/ai-review/result/script/{reviewId}`	스크립트 검수 결과 조회
`GET`	`/ai/influence/contents/ai-review/result/video/{itemId}`	영상 검수 결과 조회

모든 엔드포인트는 크리에이터 JWT 인증이 필요하며, 본인이 신청한 건에 한해서만 접근할 수 있습니다.

에러 응답은 공통 형식 { status, code, message }을 따릅니다. 현재 대부분의 검증 실패는 404(INVALID_DATA), 소유권 실패는 403으로 반환되며, 일부 코드(예: 횟수 소진 → 409)는 추후 정밀화될 수 있습니다.