문서 / 시작하기

빠른 시작

개발자 프리뷰

세 단계: 토큰을 받고, 검색을 한 번 하고, 질문을 한 번 합니다. “사용 가능”으로 표시된 엔드포인트는 지금 쓸 수 있고, “계획 중”으로 표시된 것은 오픈 코어와 함께 공개됩니다.

1
토큰 받기
토큰은 데이터 디렉터리의 token 파일에 있습니다. 처음 시작할 때 자동으로 만들어지며, 현재 사용자만 읽을 수 있습니다.
터미널
cat <데이터 디렉터리>/token
# 모든 /api/v1 엔드포인트에 필요합니다. 기본값으로는 127.0.0.1:8090에서만 요청을 받습니다
2
검색
자연어로 자료를 검색합니다. 결과에는 파일, 위치, 해당 구절이 들어 있으며 파일 이름에 의존하지 않습니다.
터미널
curl http://127.0.0.1:8090/api/v1/search \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"query": "공급업체 계약의 결제 조건", "top_k": 5}'
3
질문
스트리밍으로 돌려줍니다. search를 켜면 내 자료만 근거로 답하고 출처를 붙입니다.
터미널
curl -N http://127.0.0.1:8090/api/v1/chat/stream \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"messages": [{"role": "user", "content": "지난주 회의에서 무엇을 정했나요?"}],
       "search": true}'

API 상태

API기능상태
MCP · ownward-mcp
MCP를 지원하는 에이전트가 검색, 질의응답, 라이브러리를 바로 쓸 수 있게 합니다. 부작용이 있는 도구는 외부에 공개하지 않습니다.
사용 가능
POST /api/v1/search
문서, 이미지, 오디오, 동영상을 한 번에 검색합니다.
사용 가능
POST /api/v1/search-image
이미지로 이미지를 검색합니다.
사용 가능
POST /api/v1/search/video-clips
동영상에서 정확한 구간을 찾습니다.
사용 가능
POST /api/v1/chat/stream
SSE로 스트리밍하는 질의응답, 출처 포함.
사용 가능
POST /api/v1/generate
이미지·영상 생성. 이 기기에서 끝낼 수 없는 길이는 즉시 거절하며, 지원하는 최대 길이를 알려 줍니다.
사용 가능
GET /hub/index.json
시나리오 카탈로그. 저장하기 전에 sha256으로 검증합니다.
사용 가능
SDK · Python / JS / C++
위의 엔드포인트를 각 언어용 클라이언트 라이브러리로 묶은 것입니다.
계획 중
OpenAI 호환 API
기존 도구는 엔드포인트 주소만 바꾸면 연결됩니다.
계획 중
MCP 커넥터
MCP를 통해 서드파티 도구와 데이터 소스를 연결합니다.
계획 중

모델

모든 작업에 기본 선택지가 있으며 설정에서 바꿀 수 있습니다. 클라우드 모델은 선택 사항이며 기본적으로 꺼져 있습니다.

검색
텍스트 및 멀티모달
임베딩 · 리랭킹 · 희소 검색 · 문서 페이지 비전
이미지
이미지 이해
이미지-텍스트 의미 · 얼굴 · OCR · 캡션
오디오
음성 이해
받아쓰기 · 단어 단위 정렬 · 화자 · 이벤트
동영상
동영상 분석
샷 분할 · 검출 및 추적
대화
질의응답 및 계획
로컬 대화 모델
생성
이미지·영상 생성
이미지 · 영상 · 음성 합성
문서
레이아웃 이해
페이지 구조 · 요소 단위 이해
교체 가능
종속되지 않음
설정에서 범주별로 전환
개발자 프리뷰 신청 준비 중
신청 창구를 준비하고 있으며, 열리면 이곳에 알려 드립니다.