Skip to main content
GET
/
v3
/
token
Generate temporary streaming token
curl --request GET \
  --url https://streaming.assemblyai.com/v3/token \
  --header 'Authorization: <api-key>'
{
  "token": "your-temporary-token",
  "expires_in_seconds": 60
}

Documentation Index

Fetch the complete documentation index at: https://assemblyai.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Your AssemblyAI API key

Query Parameters

​
expires_in_seconds
integer
required

Token redemption window, in seconds. The token must be used to open a WebSocket connection within this window. If the window has elapsed when the WebSocket is opened, the server rejects the session on the first frame. This does NOT cap the duration of the resulting streaming session — once the WebSocket is open the session runs for up to max_session_duration_seconds.

Required range: 1 <= x <= 600
Example:

60

​
max_session_duration_seconds
integer
default:10800

Maximum duration of the streaming session started with this token, in seconds. If you need to finalize work before the session ends, run a client-side timer using the value you passed here.

Required range: 60 <= x <= 10800
Example:

600

Response

Successfully generated temporary token

​
token
string
required

The temporary authentication token

Example:

"your-temporary-token"

​
expires_in_seconds
integer
required

The token redemption window in seconds — the time the client has to use this token to open a WebSocket before it expires unused. This is not the session duration; see max_session_duration_seconds for that.

Example:

60