API 개요¶

VSS Feature Store의 전체 API 레퍼런스

API 구조¶

캡션 조회 (Read)¶

API	설명	사용 사례
search_metadata	메타데이터 검색	특정 조건의 비디오 찾기
get_captions	단일 캡션 조회	특정 비디오 캡션 가져오기
get_captions_batch	배치 캡션 조회	여러 비디오 캡션 한 번에 가져오기

캡션 등록 (Write)¶

API	설명	사용 사례
register_captions	단일 캡션 등록	1개 비디오 캡션 등록
register_captions_batch	배치 캡션 등록	여러 비디오 캡션 한 번에 등록

비디오 관리 (Video)¶

API	설명	사용 사례
get_video	단일 비디오 조회	비디오 메타데이터 확인
get_all_videos	전체 비디오 조회	등록된 모든 비디오 목록

일반적인 워크플로우¶

워크플로우 1: 데이터 탐색¶

# 1. 메타데이터 검색
metadata = api.search_metadata(
    feature_view='caption_summary',
    models=['gpt-4o']
)

# 2. 배치 조회
captions = api.get_captions_batch(
    feature_view='caption_summary',
    metadata=metadata
)

워크플로우 2: 데이터 등록¶

# 1. JSON 파일 준비
batch_data = [...]

# 2. 배치 등록
result = api.register_captions_batch(
    feature_view='caption_summary',
    json_file_path='batch.json'
)

공통 파라미터¶

feature_view¶

모든 API에서 사용하는 필수 파라미터:

'video_description': 비디오 세그먼트 캡션
'audio_transcript': 비디오 세그먼트 ASR 결과
'caption_summary': 비디오 세그먼트 요약 (캡션 + ASR)