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