본문으로 건너뛰기

소개

API로 할 수 있는 일​

YAHO는 Pyler의 공개 영상 이해 API입니다. 영상을 넘기면 장면으로 나누고, 장면마다 장면 감지·캡션 생성·임베딩·검수를 실행합니다. 결과는 직접 봐야 하는 영상 파일이 아니라 바로 조회할 수 있는 구조화된 데이터입니다.

모든 장면에는 다음 정보가 담깁니다.

  • 캡션, 해당 구간의 트랜스크립트, 화면 속 텍스트
  • 감지된 브랜드, 제품 카테고리, 인물, 장소, 행동, 날씨
  • 분위기(valence / arousal), 음악 분위기, 오디오 이벤트
  • GARM 브랜드 세이프티 카테고리
  • 사전 서명된 키프레임·클립 URL

모든 영상에는 요약, 장르, IAB 콘텐츠·오디언스 카테고리, 카테고리별 GARM 평가(high / medium / low)와 그 근거가 된 시간 구간이 담깁니다.

이 색인 위에서 다음 기능을 쓸 수 있습니다.

기능엔드포인트
URL, 파일 업로드, 배치, 시트로 영상 색인POST /api/v1/videos, POST /api/v1/videos/upload, POST /api/v1/videos/batch/*
장면과 분석 결과 조회GET /api/v1/videos/{video_id}, GET /api/v1/videos/{video_id}/scenes
자연어, 이미지, 오디오로 검색POST /api/v1/search, POST /api/v1/search/multimodal, POST /api/v1/search/deep
광고 소재의 브랜드 세이프티 심사POST /api/v1/ad-blocking, POST /api/v1.1/ad-blocking
광고에 맞는 영상 매칭POST /api/v1/ads/match
HLS 라이브 스트림 모니터링/api/v1/live/*
조직의 사용 한도 확인GET /api/v1/usage

기본 URL과 버전​

모든 요청은 다음 주소로 보냅니다.

https://video.pyler.ai

버전 루트는 두 개입니다. 둘 다 같은 API 키를 받습니다.

루트내용
/api/v1모든 핵심 경로: 색인, 작업, 장면, 검색, 광고, 브랜드 세이프티, 라이브, 사용량.
/api/v1.1이미 등록된 ad_id를 입력으로 받는 경로. 현재는 POST /api/v1.1/ad-blocking과 GET /api/v1.1/ad-blocking입니다. v1 경로는 그대로입니다.
노트

색인 생성은 비동기로 진행됩니다. POST /api/v1/videos는 job_id와 함께 202 Accepted를 반환합니다. status가 done 또는 failed가 될 때까지 GET /api/v1/jobs/{job_id}를 폴링하세요.

스트리밍 엔드포인트​

일부 엔드포인트는 단일 문서 대신 NDJSON(한 줄에 JSON 객체 하나)을 반환합니다. 여러 단계로 된 파이프라인이 실행되는 동안에도 부분 결과를 쓸 수 있습니다. 응답 본문은 한 줄씩 파싱하세요.

다음 단계​

빠른 시작

영상을 제출하고, 작업을 폴링하고, 장면을 읽고, 첫 검색을 실행합니다.

인증

대시보드에서 API 키를 발급받아 bearer 토큰으로 보냅니다.

오류

오류 응답 형식, 검증 오류, 재시도 시점을 설명합니다.

데이터 처리

저장되는 데이터, 서명된 URL 만료, 데이터 삭제 방법, AI 출력을 다루는 방법을 설명합니다.

API 레퍼런스

모든 엔드포인트의 요청·응답 스키마와 라이브 플레이그라운드를 제공합니다.

정보

대시보드에 로그인하면 같은 OpenAPI 문서로 만든 대화형 Swagger UI를 video.pyler.ai/api-docs에서 쓸 수 있습니다.