동영상 분석
사용 가능120초 이하 동영상을 업로드하세요. 각 샷의 시간 구간과 프레임, 일어나는 일, 전환점과 결말, 리메이크할 때 지켜야 할 요소를 알려 줍니다.
Break down video
동영상을 프레임과 타임스탬프가 있는 샷별 리포트로.
실행당 결제 · 최대 120초 동영상 · 시간당 3회 분석
Files are processed privately and are not published. Analysis sends selected media to an AI model; temporary source files are removed afterward.
Open image generation and editingAPI endpoint
POST /v1/media/video-breakdownAuthenticate with an API key. Download accepts JSON with url and optional max_height; inspection accepts multipart file. Keys stay in memory.
예시 결과크리에이티브 커먼즈 예고편으로 실제 실행한 결과입니다. 내 링크나 파일로 바꿔 보세요.
Big Buck Bunny trailer (CC) Blender Foundation | www.bigbuckbunny.org — CC BY 3.0, via Wikimedia Commons
이용 방법
- 01동영상 추가120초 이하 클립을 업로드하거나 먼저 링크로 다운로드하세요.
- 02리포트 받기각 샷의 시간 구간, 프레임, 내용.
- 03확인하고 활용하기프레임을 클릭해 그 장면으로 이동하고, 표시된 부분을 확인하고, 리포트를 JSON으로 저장하세요.
코드에서 동영상 분석 호출하기
One endpoint and one key, on the same balance as the playground. The request below is the example's own.
https:/API 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기첫 요청 보내기
플레이그라운드가 보내는 것과 같은 요청입니다. OPENNAN_KEY에 키를 넣으세요.
curl https://api.opennan.com/v1/media/video-breakdown \ -H "Authorization: Bearer $OPENNAN_KEY" \ -F "[email protected]"결과 읽기
결과는 같은 응답으로 옵니다. X-Usage-Cost-Usd 헤더에 호출 비용이 나옵니다.
오류와 해결 방법
401키가 없거나 틀림
콘솔에서 만든 키를 Authorization: Bearer 헤더로 보내세요.
402잔액 부족
결제 메뉴에서 잔액을 충전한 뒤 같은 호출을 다시 보내세요.
400받을 수 없는 값
error.message에 필드 이름이 나옵니다. 파라미터 표의 값을 쓰세요.
429요청이 너무 많음
몇 초 기다렸다가 다시 시도하고, 429가 반복되면 더 오래 기다리세요.
동영상 분석: 자주 묻는 질문
동영상 분석 요금은 얼마인가요?
실행마다 사용한 AI 토큰만큼 결제합니다. 실행의 최대 비용을 먼저 잔액에서 보류하고 나머지는 돌려드립니다. AI가 파일을 읽기 전에 실패한 실행은 청구되지 않으며, AI가 파일을 읽은 뒤에는 이후 실행이 실패해도 사용한 토큰이 청구됩니다.
코드에서 어떻게 호출하나요?
API 키와 함께 POST https://api.opennan.com/v1/media/video-breakdown를 보내세요. 결과는 같은 응답으로 옵니다.
AI 에이전트가 쓸 수 있나요?
네. 에이전트에게 https://api.opennan.com/llms.txt를 알려 주세요. 이 엔드포인트와 다른 모든 엔드포인트를 설명합니다.
실행이 실패하면 어떻게 되나요?
실패한 요청은 청구되지 않습니다. 사용한 토큰만 결제합니다.