Regions

Available regions

Spatius currently operates in three regions.

Region	Notes
`us-west`	Fallback when automatic selection has no previously resolved region.
`ap-northeast`	Asia Pacific Northeast region.
`cn-beijing`	China Beijing region.

Endpoint URLs

You normally do not need to set endpoint URLs explicitly. AvatarKit clients, the Python, Go, and JavaScript Server SDKs, and the current LiveKit Agents Integration plugin select a region automatically when none is provided. Leave SPATIUS_REGION unset for the LiveKit Agents Integration unless you need a fixed region. Other integration setup pages state each plugin’s default.

Region	Console API	Motion Server ingress (v2)
`us-west`	`https://console.us-west.spatius.ai/v1/console`	`wss://api.us-west.spatius.ai/v2/driveningress`
`ap-northeast`	`https://console.ap-northeast.spatius.ai/v1/console`	`wss://api.ap-northeast.spatius.ai/v2/driveningress`
`cn-beijing`	`https://console.cn-beijing.spatialwalk.top/v1/console`	`wss://api.cn-beijing.spatius.ai/v2/driveningress`

The advanced override environment variables SPATIUS_CONSOLE_ENDPOINT and SPATIUS_INGRESS_ENDPOINT exist for staging or proxy setups. Leave them unset for normal use.

Credential portability

The following identifiers are not region-specific:

App ID
API Key
Avatar ID

You can switch between supported regions without rotating credentials or recreating apps and avatars. Session Tokens are minted per session by the Console API; generate them from the same region your Direct Mode client will use.

Reference Overview

Client SDKs

Server SDKs

Session Token API

Regions & Endpoints

Error Handling

Available regions

Endpoint URLs

Credential portability

​Available regions

​Endpoint URLs

​Credential portability

Available regions

Endpoint URLs

Credential portability