> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/dsx-air/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.nvidia.com/dsx-air/_mcp/server.

# air_sdk.const

Constants shared throughout the SDK.

## Attributes

| Name                                                                            |
| ------------------------------------------------------------------------------- |
| [`SDK_ROOT`](#air_sdkconstsdk_root)                                             |
| [`MAX_STACKLEVEL`](#air_sdkconstmax_stacklevel)                                 |
| [`DEFAULT_CONNECT_TIMEOUT`](#air_sdkconstdefault_connect_timeout)               |
| [`DEFAULT_READ_TIMEOUT`](#air_sdkconstdefault_read_timeout)                     |
| [`DEFAULT_PAGINATION_PAGE_SIZE`](#air_sdkconstdefault_pagination_page_size)     |
| [`DEFAULT_MGMT_IFACE_NAME`](#air_sdkconstdefault_mgmt_iface_name)               |
| [`DEFAULT_RETRY_ATTEMPTS`](#air_sdkconstdefault_retry_attempts)                 |
| [`DEFAULT_RETRY_BACKOFF_FACTOR`](#air_sdkconstdefault_retry_backoff_factor)     |
| [`DEFAULT_RETRY_BACKOFF_JITTER`](#air_sdkconstdefault_retry_backoff_jitter)     |
| [`MULTIPART_CHUNK_SIZE`](#air_sdkconstmultipart_chunk_size)                     |
| [`MULTIPART_MIN_PART_SIZE`](#air_sdkconstmultipart_min_part_size)               |
| [`MAX_RECOMMENDED_UPLOAD_WORKERS`](#air_sdkconstmax_recommended_upload_workers) |
| [`DEFAULT_UPLOAD_TIMEOUT`](#air_sdkconstdefault_upload_timeout)                 |
| [`SCOPED_KEY_PREFIX`](#air_sdkconstscoped_key_prefix)                           |
| [`AIR_API_URL`](#air_sdkconstair_api_url)                                       |
| [`NGC_API_PROD_URL`](#air_sdkconstngc_api_prod_url)                             |
| [`NGC_API_STG_URL`](#air_sdkconstngc_api_stg_url)                               |

## Classes

| Name                                            | Description            |
| ----------------------------------------------- | ---------------------- |
| [`HTTPHeaders`](#air_sdkconsthttpheaders)       | Known HTTP headers.    |
| [`TopologyFormat`](#air_sdkconsttopologyformat) | Topology format types. |

## Functions

| Name                                                                                            | Description                                           |
| ----------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| [`get_ngc_api_base_url`](#air_sdkconstget_ngc_api_base_url)(→ urllib.parse.ParseResult)         | Return the NGC API base URL based on the Air API URL. |
| [`get_ngc_device_login_url`](#air_sdkconstget_ngc_device_login_url)(→ urllib.parse.ParseResult) | Return the NGC device login URL.                      |
| [`get_ngc_token_url`](#air_sdkconstget_ngc_token_url)(→ urllib.parse.ParseResult)               | Return the NGC token URL.                             |
| [`get_ngc_sak_details_url`](#air_sdkconstget_ngc_sak_details_url)(→ urllib.parse.ParseResult)   | Return the NGC SAK details URL.                       |
| [`get_ngc_me_url`](#air_sdkconstget_ngc_me_url)(→ urllib.parse.ParseResult)                     | Return the NGC user info URL.                         |

## Module Contents

```python
SDK_ROOT = dirname(...)
```

```python
MAX_STACKLEVEL = 20
```

```python
DEFAULT_CONNECT_TIMEOUT = timedelta(...)
```

```python
DEFAULT_READ_TIMEOUT = timedelta(...)
```

```python
DEFAULT_PAGINATION_PAGE_SIZE = 200
```

```python
DEFAULT_MGMT_IFACE_NAME = eth0
```

```python
DEFAULT_RETRY_ATTEMPTS: int = 5
```

```python
DEFAULT_RETRY_BACKOFF_FACTOR: float = 1.0
```

```python
DEFAULT_RETRY_BACKOFF_JITTER: float = 1.0
```

```python
MULTIPART_CHUNK_SIZE
```

```python
MULTIPART_MIN_PART_SIZE
```

```python
MAX_RECOMMENDED_UPLOAD_WORKERS = 10
```

```python
DEFAULT_UPLOAD_TIMEOUT = timedelta(...)
```

```python
class air_sdk.const.HTTPHeaders
```

**Bases**: `str`, `enum.Enum`

Known HTTP headers.

```python
CONTENT_TYPE = Content-Type
```

```python
AUTHORIZATION = Authorization
```

```python
USER_AGENT = User-Agent
```

```python
AIR_SDK_SYS_VERSION = X-Air-Sdk-Sys-Version
```

```python
AIR_SDK_VERSION = X-Air-Sdk-Version
```

```python
AIR_SDK_TIMEZONE = X-Air-Sdk-Timezone
```

```python
AIR_SDK_PLATFORM = X-Air-Sdk-Platform
```

```python
class air_sdk.const.TopologyFormat
```

**Bases**: `str`, `enum.Enum`

Topology format types.

```python
JSON = JSON
```

```python
DOT = DOT
```

```python
SCOPED_KEY_PREFIX = nvapi-
```

```python
AIR_API_URL = https://api.air-ngc.nvidia.com/
```

```python
NGC_API_PROD_URL = https://api.ngc.nvidia.com
```

```python
NGC_API_STG_URL = https://api.stg.ngc.nvidia.com
```

```python
air_sdk.const.get_ngc_api_base_url(api_url: str) -> urllib.parse.ParseResult
```

Return the NGC API base URL based on the Air API URL.

If the api\_url contains 'stg', the staging NGC URL is used.
Otherwise, the production NGC URL is used.

```python
air_sdk.const.get_ngc_device_login_url(api_url: str) -> urllib.parse.ParseResult
```

Return the NGC device login URL.

```python
air_sdk.const.get_ngc_token_url(api_url: str) -> urllib.parse.ParseResult
```

Return the NGC token URL.

```python
air_sdk.const.get_ngc_sak_details_url(api_url: str) -> urllib.parse.ParseResult
```

Return the NGC SAK details URL.

```python
air_sdk.const.get_ngc_me_url(api_url: str) -> urllib.parse.ParseResult
```

Return the NGC user info URL.