---
title: "Get speech token"
method: GET
path: "/liteforms/speech_token"
tags: ["Liteforms"]
---

# Get speech token

`GET /liteforms/speech_token`

Get a Microsoft speech token for the user in order to use TTS and STT speech services. This token expires after 10 minutes and must be refreshed. This will fail if the user has exceeded their usage limit.

## Response `200`

Successful response

- LiteformsSpeechTokenResponse
  - `token` string, required — The speech token to be used for Microsoft speech services.
  - `region` string, required — The region of the speech token.
  - `usage` object, required
    - `totalSeconds` number, required — The number of seconds of usage so far.
    - `totalSecondsRemaining` number, required — The number of seconds remaining. Once this value equals zero, the rest of the API calls will fail.
    - `totalGPTTokens` number, required — The number of GPT tokens used so far.
    - `totalSTTSeconds` number, required — The number of STT seconds used so far.
    - `totalTTSSeconds` number — The number of TTS seconds used so far.
    - `totalTTSChars` number, required — The number of TTS characters used so far.
    - `totalImagesCreated` number, required — The number of images created.
    - `startedAt` string, date-time, required — The date the usage period started.
    - `resetsAt` string, date-time, required — The date the usage period will reset.

## Other responses

- `401` — Invalid authentication credentials.
- `408` — The server timed out waiting for the request.
- `412` — Usage has exceeded the monthly limit.
- `500` — An unspecified error occurred.

---

[API](https://skmtc.dev/blocks/apis/looking-glass-api.md) · [All operations](https://skmtc.dev/blocks/apis/looking-glass-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/blocks/looking-glass-api/revisions/c79a9a0e44b0/schema)