Regions

Available regions

Spatius currently operates in three regions.

Region	Notes
`us-west`	Default for the Go Server SDK; fallback for automatic selection.
`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 Server SDK, 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. The Go Server SDK defaults to us-west; 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