---
title: "Create Asr Token"
method: POST
path: "/api/v1/whiteboard/asr-token"
tags: ["whiteboard"]
---

# Create Asr Token

`POST /api/v1/whiteboard/asr-token`

## 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/asr-token`
- Auth: none declared

簽發 ElevenLabs Scribe v2 Realtime 的 single-use token（15 分鐘效期）。

瀏覽器拿 token 後直連 ElevenLabs WebSocket，ELEVENLABS_API_KEY 永遠不出後端。
不可用時回 available=false（200），前端自動降級瀏覽器內建辨識。
計費（2026-10-07 定價）：收音每滿 10 分鐘一段、每段 100 credits，開始收音即扣第一段；
結算點綁 token 簽發（token 15 分鐘效期本來就會重簽），同堂重連只補差額不重複扣。
降級瀏覽器內建辨識不簽 token、不計費。
啟動延遲：回應只等 ElevenLabs 外網請求 ∥ 段數計算（＋新段時的餘額檢查，皆唯讀）；
扣款（Firestore 交易，實測可達 10-25 秒）後置背景執行，不拉長重連空窗。

## Headers

- `Authorization` string, nullable

## Request body

- WhiteboardAsrTokenRequest
  - `session_started_at` integer, nullable

## Response `200`

Successful Response

- WhiteboardAsrTokenResponse
  - `available` boolean, required
  - `token` string, nullable
  - `expires_in` integer
  - `reason` string, nullable
  - `charged_segments` integer
  - `segment_credits` integer

## 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)