# API 레퍼런스

> Xisom 런타임이 노출하는 REST 및 gRPC API.

모든 HTTP 엔드포인트는 `/api/v1/` 아래에 버전이 지정되어 있으며 베어러 토큰이 필요합니다. gRPC 서비스는 `50051` 포트에 노출됩니다.

## 인증

```http
Authorization: Bearer <token>
```

**관리자 → API 키** 페이지 또는 `/api/v1/auth/token` 엔드포인트를 통해 토큰을 얻을 수 있습니다.

## 추론

**POST** `/api/v1/inference`

**GET** `/api/v1/inference/{id}`

## 모델

**GET** `/api/v1/models`
**POST** `/api/v1/models`
**POST** `/api/v1/models/{name}/promote`

## OpenAPI

전체 OpenAPI 스펙은 실행 중인 모든 장치의 `/api/v1/openapi.json`에 게시됩니다.