Main API
AI 영상 검수 API
AI 기반 영상 검수 API
AI 영상 검수 API
AI를 활용한 인플루언서 영상 검수 API입니다.
Base URL: /ai/review
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/review/video | 영상 검수 | 필요 |
API 상세
영상 검수
인플루언서가 제출한 영상을 AI로 검수합니다.
HTTP 요청
POST /ai/review/video
Authorization: Bearer {access_token}
Content-Type: multipart/form-dataRequest Parameters (Form Data)
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignId | long | 예 | 캠페인 ID |
influencerDraft | string | 예 | 인플루언서 초안 JSON (caption, script 등) |
video | file | 예 | 검수할 영상 파일 |
modelVersion | string | 아니오 | Gemini 모델 버전 (gemini2 또는 gemini3). 기본값: gemini3 |
thinkingLevel | string | 아니오 | 추론 깊이 - gemini3 전용 (low 또는 high). 기본값: low |
mediaResolution | string | 아니오 | 영상 해상도 - gemini3 전용. 기본값: media_resolution_medium |
influencerDraft 예시
{
"caption": "오늘의 뷰티 루틴을 소개합니다! ✨",
"script": "안녕하세요, 오늘은 제가 매일 사용하는...",
"hashtags": ["#뷰티", "#스킨케어", "#데일리루틴"]
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "영상 검수가 완료되었습니다.",
"data": "검수 결과 상세 내용..."
}에러 응답
| 상태 코드 | 코드 | 메시지 |
|---|---|---|
| 500 | VIDEO_REVIEW_ERROR | 영상 검수 중 오류가 발생했습니다 |
Gemini 모델 버전
| 버전 | 설명 |
|---|---|
gemini2 | Gemini 2.0 모델 |
gemini3 | Gemini 3.0 모델 (기본값, 더 정확한 검수) |
추론 깊이 (Thinking Level)
thinkingLevel은 gemini3 모델에서만 적용됩니다.
| 레벨 | 설명 |
|---|---|
low | 빠른 검수 (기본값) |
high | 심층 분석 검수 |
영상 해상도 (Media Resolution)
mediaResolution은 gemini3 모델에서만 적용됩니다.
| 해상도 | 설명 |
|---|---|
media_resolution_low | 저해상도 처리 |
media_resolution_medium | 중해상도 처리 (기본값) |
media_resolution_high | 고해상도 처리 |
사용 예시
curl -X POST https://api.glowb.io/ai/review/video \
-H "Authorization: Bearer {token}" \
-F "campaignId=123" \
-F "influencerDraft={\"caption\":\"테스트\",\"script\":\"테스트 스크립트\"}" \
-F "video=@/path/to/video.mp4" \
-F "modelVersion=gemini3" \
-F "thinkingLevel=low"