# Tham chiếu API

> API REST và gRPC do Xisom runtime cung cấp.

Tất cả endpoint HTTP được version dưới `/api/v1/` và yêu cầu bearer token. Dịch vụ gRPC chạy trên cổng `50051`.

## Xác thực

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

Lấy token tại trang **Admin → API Keys** hoặc qua `/api/v1/auth/token`.

## Suy luận

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

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

## Models

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

## OpenAPI

Spec OpenAPI đầy đủ được công bố tại `/api/v1/openapi.json` trên mỗi thiết bị đang chạy.