Skip to main content
POST
Create a WebRTC session

承認

Authorization
string
header
デフォルト:$CARTESIA_API_KEY
必須

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-08-14
必須

API version header.

利用可能なオプション:
2026-08-14
例:

"2026-08-14"

パスパラメータ

agent_id
string
必須

Unique identifier for the agent.

Minimum string length: 1

ボディ

application/json
dynamic_variables
object

Trusted values that Cartesia stores on the call and supplies to the agent.

config_overrides
object

Per-call overrides using the same field structure as agent configuration. Omitted fields use the agent's published configuration.

レスポンス

The pre-created call and its browser WebRTC credentials

call_id
string
必須

ID of the pre-created call.

url
string<uri>
必須

LiveKit server URL the browser connects to.

token
string
必須

Short-lived LiveKit participant token for the browser connection. Do not log it.

room
string
必須

LiveKit room the browser joins.

expires_at
string<date-time>
必須

Connection deadline. Create a new session if the browser does not join before this time.