Sentinel API v1

첫 API 호출부터 프로덕션까지

Sentinel API v1

기존 카메라로 이벤트 워크플로 구축

Configure cameras and monitoring rules in the Web GUI, then receive webhook events in your system. Use the full REST API when building your own interface or embedding the runtime in your product.

Just need alerts? Start here.

Deploy Docker → Configure in the Web GUI → Receive webhooks. Receiver source included.

Quick integration guide
Source

RTSP 또는 테스트 이미지

Monitor

모니터링할 대상

Event

버전이 지정된 이벤트

증거

보호된 JPEG URL

API development & testing

컨테이너를 시작하고 이미지 한 장을 보내 첫 이벤트를 받으세요.

Docker를 먼저 설치하고 실행해야 합니다. 카메라, GPU, 클라우드 계정은 필요 없습니다. 빠른 시작에서는 테스트 소스와 JPEG로 API 키, 모델, 이벤트, webhook, 증거 다운로드를 처음부터 끝까지 검증합니다.

시작

API 작업 흐름

Camera / JPEG → Source → Monitor → Event → image_url → your system

Source는 영상 출처를, Monitor는 어떤 상황을 이벤트로 만들지 정의합니다. Event JSON이 안정적인 연동 출력입니다. 모델이 작성한 문장은 보조 정보이므로 심각도나 이벤트 유형을 판별하기 위해 파싱해서는 안 됩니다.

프로덕션에 콘솔은 필수가 아닙니다. 선택적인 테스트 및 시운전 도구이며, 닫아도 API 런타임, 영속 monitors, webhook 재시도는 멈추지 않습니다. 기존 데스크톱 호환 모드는 세션이 UI 수명 주기에 연결될 수 있으므로 API 런타임 모드와 혼동하지 마세요.

제품명 및 제공 상태

Sentinel Edge Runtime현재 소스 키트

UI 없이 영상 수집, 추론, 이벤트 영구 저장, webhook 처리를 수행하는 런타임.

Sentinel API v1현재 명세

Sentinel Edge의 공개 REST/OpenAPI 연동 명세.

Sentinel Console현재 제공 · 선택 사항

테스트 및 시운전용 UI. API 런타임에 필수는 아닙니다.

cloud_gemini현재 제공 · 명시적 활성화 필요

프로덕션 사용 전 모델 상태 확인, 모델 테스트, 대표 이미지 인수 검증이 필요합니다. 활성화하면 크기가 제한된 추론 이미지와 필요한 메타데이터가 Edge 외부로 전송됩니다.

호스팅형 제어 영역계획 단계 · 미제공

공개 멀티테넌트 Sentinel 클라우드 제어 영역은 현재 제공하지 않습니다.

작업별 찾아보기

시작

명세를 이해하고 첫 이벤트를 검증하세요.

개발

영상을 연결하고 자체 시스템으로 이벤트를 전달하세요.

운영

배포, 모델 선택, 상태 모니터링을 수행하고 프로덕션을 준비하세요.

레퍼런스

필드, 공통 동작, 예제, 버전 정책을 찾아보세요.

호환성

기존 연동의 마이그레이션 전용입니다. 이 경로들은 공개 /v1 OpenAPI 밖에 있으며 새로운 개발 절차에 포함되지 않습니다.

인터페이스 및 버전

Base URL   http://localhost:8000
API prefix /v1
Auth       Authorization: Bearer <api-key>
OpenAPI    GET /v1/openapi.json
Reference  GET /v1/docs

새 공개 연동 명세는 /v1만 해당합니다. 기존 /api/*, WebSocket, MCP 경로는 마이그레이션 기간 동안 호환 인터페이스로 유지됩니다.