영상 분석
업로드한 MP4 또는 MOV를 standard 또는 deep 타임스탬프 인식 멀티모달 추론으로 분석합니다.
입력이 로컬 파일이면 로컬 입력을 업로드하고 반환된 data.url을 사용하세요. data.id를 저장하고, 작업을 폴링하며, 오류 및 재시도 정책을 따르세요.
인증
AuthorizationBearer
API 키를 Authorization: Bearer <BEATAPI_API_KEY>로 보내세요.
헤더
Idempotency-Key
재시도용 키입니다(선택 사항). 정규화된 같은 요청에 같은 키를 다시 쓰면 접수된 작업을 반환합니다.
요청
This endpoint expects an object.
video_url
현재 계정에서 POST /v1/files가 반환한 BeatAPI 호스팅 MP4 또는 MOV 입력 URL입니다. 검증된 최대 길이는 600초입니다.
prompt
분석 지시문입니다. 시간 정밀도가 중요하면 타임스탬프가 있는 출력을 요청하세요.
analysis_depth
standard는 저비용 기본 경로이고, deep은 더 높은 추론 경로를 사용합니다.
허용된 값:
max_output_tokens
요청한 답변 한도입니다. 모델이 보고하는 출력 사용량에는 이 값을 넘는 숨은 추론 토큰이 포함될 수 있으며, BeatAPI는 그 차이를 감사용으로 기록하고 작업 보류 금액 안에서 실제 보고된 사용량으로 정산합니다.
응답
비동기 처리를 위해 분석이 접수되었습니다.
data
접수되었거나 현재의 BeatAPI 작업 상태입니다.
오류
400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
403
Forbidden Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error