SaaS APIAI 검수 (셀프 요청)
POST /ai/influence/contents/ai-review/request/video/{itemId}
영상 AI 검수 요청
영상 AI 검수 요청
해당 영상 제출물에 업로드된 파일을 AI 영상 검수에 비동기로 요청합니다. 요청이 수락되면 VIDEO 횟수가 1회 차감됩니다.
제출 여부와 무관하게 업로드된 영상 파일이 있으면 요청할 수 있습니다.
요청 직전 업로드 완료 필수. 이 API는 제출물에 **저장된 영상 URL(filePath)**을 검수합니다 — 요청 바디를 받지 않습니다. 프론트엔드는 "AI 검수 받기" 시 영상을 먼저 업로드(presigned URL)하여 filePath가 저장된 뒤 이 엔드포인트를 호출해야 합니다. (업로드/저장 → 검수요청 순서)
HTTP 요청
POST /ai/influence/contents/ai-review/request/video/{itemId}
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
itemId | long | 예 | 영상 제출물 ID |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "AI 영상 검수 요청이 수락되었습니다.",
"data": {
"accepted": true,
"contentType": "VIDEO",
"usedCount": 1,
"maxCount": 5,
"remaining": 4
}
}응답 필드 (data)
| 필드 | 타입 | 설명 |
|---|---|---|
accepted | boolean | 요청 수락 여부 |
contentType | string | 차감된 타입 (VIDEO) |
usedCount | int | 요청 후 사용 횟수 |
maxCount | int | 최대 허용 횟수 |
remaining | int | 남은 횟수 |
에러 응답
| 상태 코드 | 설명 |
|---|---|
403 | 본인 신청이 아님 (소유권 검증 실패) |
404 | 제출물 타입이 VIDEO가 아님 |
404 | 업로드된 영상 없음 — 횟수 미차감, 요청 거부 |
404 | 횟수 모두 소진 — 관리자 추가 부여 필요 |
영상 검수는 비동기로 진행됩니다. 결과는 GET /ai/influence/contents/ai-review/result/video/{itemId} 로 조회하세요. 완료까지 평균 10~15분 소요됩니다.