---
title: "Mint a live transcription handshake token"
method: POST
path: "/live-transcription/token"
tags: ["Live Transcription"]
---

# Mint a live transcription handshake token

`POST /live-transcription/token`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/live-transcription/token`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

Mint the short-lived token that opens a live transcription streaming connection for the calling session.

The token is scoped to live transcription only. It is rejected anywhere else in the API, so it cannot stand in for an access token.

This endpoint takes no request body. The response carries the token and the number of seconds it stays valid for.

### Rate limit

This endpoint is limited to 5 requests per 60 seconds per IP address. Going over returns `429` with a plain text body, so mint one token per session and reuse it until it expires.

## Response `200`

OK

- object
  - `status` string
  - `data` object
    - `token` string
    - `expiresIn` string

## Other responses

- `429`: Too Many Requests
- `500`: Internal Server Error

---

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