메인 콘텐츠로 건너뛰기

​
소개

OneSight Open API는 외부 애플리케이션(모바일 앱, POS 시스템, IoT 장치 등)이 OneSight 플랫폼의 AI 기능을 사용할 수 있도록 제공하는 RESTful API입니다.

​
주요 기능

기능설명엔드포인트
AI 채팅OpenAI 호환 채팅 API (스트리밍 지원)POST /api/openapi/v1/chat/completions
데이터 수집스키마-프리 이벤트 데이터 수집POST /api/openapi/v1/data/events
모델 목록사용 가능한 Open API 모델 조회GET /api/openapi/v1/models
사용량 조회API 키별 사용량 통계GET /api/openapi/v1/usage

​
아키텍처

외부 앱 (iOS, POS, IoT)
        │
        │ HTTPS + Bearer API Key
        ▼
┌──────────────────────────┐
│  OneSight Gateway        │
│  /api/openapi/v1/*       │
│                          │
│  인증 → enrichment → 프록시│
└──────────┬───────────────┘
           │
           ▼
┌──────────────────────────┐
│  RAG Service (LLM)       │
│  AI 응답 생성 + 도구 실행  │
└──────────────────────────┘

​
Quick Start

​
1. API 키 발급

테넌트 관리자 계정으로 로그인한 후, 프로필 메뉴에서 Open API 페이지로 이동하여 API 키를 발급합니다.

​
2. 채팅 API 호출

curl -X POST https://api.aika.life/api/openapi/v1/chat/completions \
  -H "Authorization: Bearer osk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "shopping-assistant",
    "messages": [
      {"role": "user", "content": "오늘 저녁 메뉴 추천해줘"}
    ],
    "stream": true
  }'

​
3. 응답 확인

SSE 스트리밍 형식으로 응답이 반환됩니다: 
data: {"choices":[{"delta":{"content":"카레"},"index":0}]}

data: {"choices":[{"delta":{"content":"라이스는"},"index":0}]}

data: [DONE]

​
인증 방식

모든 Open API 요청에는 Authorization: Bearer {API_KEY} 헤더가 필요합니다. 자세한 내용은 인증 페이지를 참조하세요.

​
모델 분리

Open API에서 사용하는 AI 모델은 테넌트 채팅 모델과 별도로 관리됩니다. 어드민에서 Open API 타입으로 모델을 생성하면 외부 앱에서만 사용할 수 있습니다.