> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spatius.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Regions

> Supported Spatius regions, endpoint composition, credential portability, and advanced endpoint override notes.

## Available regions

Spatius currently operates in three regions.

| Region         | Notes                                     |
| -------------- | ----------------------------------------- |
| `us-west`      | Default region used by SDKs and examples. |
| `ap-northeast` | Asia Pacific Northeast region.            |
| `cn-beijing`   | China Beijing region.                     |

## Endpoint URLs

You normally do not need to set endpoint URLs explicitly. Set only `SPATIUS_REGION`; SDKs and plugins compose the right hosts from the region. If unset, SDKs default to `us-west`.

| 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.
