---
title: "Classify"
method: POST
path: "/api/v1/whiteboard/classify"
tags: ["whiteboard"]
---

# Classify

`POST /api/v1/whiteboard/classify`

## Request

- Base URL: `https://api.slidemaster.tw` (the document declares no server; this is the origin it was published from)
- URL: `https://api.slidemaster.tw/api/v1/whiteboard/classify`
- Auth: none declared

語音定稿句 → 板書元素（模板 + 大標 + 項目 + 信心）。延遲目標 <1s，永不因 AI 失敗而卡住。

## Headers

- `Authorization` string, nullable

## Request body

- WhiteboardClassifyRequest
  - `text` string, required: 語音定稿句
  - `keywords` string[]: 課前預載關鍵詞
  - `recent_headlines` string[]: 本頁已寫上的大標（append 判斷用）

## Response `200`

Successful Response

- WhiteboardClassifyResponse
  - `text_traditional` string, required
  - `template` string, required
  - `headline` string, required
  - `items` string[], required
  - `confidence` number, required
  - `append` boolean, required
  - `new_topic` boolean
  - `group_with` string
  - `source` string, required
  - `latency_ms` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api.md) · [All operations](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slidemaster/apis/slidemaster-ai-api/revisions/a964c005977e?raw)