Sign in

v50

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-01600974.4 KB
Realtime Sessions

Create realtime session

Create a new realtime session with the specified model configuration. The returned ID is also the conversation ID used later to fetch transcripts and recordings from the avatar conversation endpoints.

post/v1/realtime_sessions

Headers

X-Runway-Version'2024-11-06' required

The version of the RunwayML API being used. You can read more about versioning here.

Request body

model'gwm1_avatars' required

The realtime session model type.

maxDurationinteger

Maximum session duration in seconds.

personalitystring

Override the avatar personality for this session. If not provided, uses the avatar default.

startScriptstring

Override the avatar start script for this session. If not provided, uses the avatar default.

Response

Success

idstring uuid required

The ID of the created realtime session. This same value is later used as the conversation ID in the avatar conversation endpoints.