AI 비디오 노트
Baidu AI를 사용하여 비디오 URL로부터 구조화된 노트를 생성합니다. 세 가지 노트 형식을 지원합니다.
워크플로우
- 작업 생성: 비디오 URL 제출 → 작업 ID 획득
- 상태 폴링: 완료될 때까지 3~5초 간격으로 작업 상태 확인
- 결과 획득: 상태가 10002일 때 생성된 노트 검색
상태 코드
| 코드 | 상태 | 동작 |
|---|---|---|
| 10000 | 진행 중 | 계속 폴링 |
| 10002 | 완료 | 결과 반환 |
| 기타 | 실패 | 오류 표시 |
노트 유형
| 유형 | 설명 |
|---|---|
| 1 | 문서 노트 |
| 2 | 개요 노트 |
| 3 | 그래픽-텍스트 노트 |
API
작업 생성
엔드포인트: POST /v2/tools/ai_note/task_create
매개변수:
video_url(필수): 공개 비디오 URL
예시:
python3 scripts/ai_notes_task_create.py 'https://example.com/video.mp4'
응답:
{
"task_id": "uuid-string"
}
작업 상태 조회
엔드포인트: GET /v2/tools/ai_note/query
매개변수:
task_id(필수): 생성 엔드포인트에서 받은 작업 ID
예시:
python3 scripts/ai_notes_task_query.py "task-id-here"
응답 (완료됨):
{
"status": 10002,
"notes": [
{
"tpl_no": "1",
"contents: ["노트 내용..."]
}
]
}
폴링 전략
옵션 1: 수동 폴링
- 작업 생성 →
task_id저장 - 3~5초 간격으로 조회:
python3 scripts/ai_notes_task_query.py <task_id> - 진행 상황 표시:
- 상태 10000: 처리 중...
- 상태 10002: 완료
- 30~60초 후 중지 (비디오 길이에 따라 다름)
옵션 2: 자동 폴링 (권장)
자동 상태 업데이트를 위해 폴링 스크립트 사용:
python3 scripts/ai_notes_poll.py <task_id> [max_attempts] [interval_seconds]
예시:
# 기본값: 20회 시도, 3초 간격
python3 scripts/ai_notes_poll.py "task-id-here"
# 사용자 정의: 30회 시도, 5초 간격
python3 scripts/ai_notes_poll.py "task-id-here" 30 5
출력:
- 실시간 진행률 표시:
[1/20] 처리 중... 25% - 완료 시 자동 중지
- 유형 레이블과 함께 서식화된 노트 반환
오류 처리
- 잘못된 URL: "비디오 URL에 접근할 수 없습니다"
- 처리 오류: "비디오 구문 분석 실패"
- 시간 초과: "비디오가 너무 깁니다. 나중에 다시 시도하세요"