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

# Client

```python theme={"system"}
class Client(
    *,
    url: str = "https://api.tilebox.com",
    token: str | None = None,
    warn_if_unauthenticated: bool = True,
    transport: Literal["grpc", "http1"] = "grpc",
)
```

Create a Tilebox datasets client.

## Parameters

<ParamField path="url" type="str">
  Tilebox API Url. Defaults to `https://api.tilebox.com`.
</ParamField>

<ParamField path="token" type="str | None">
  The API key to authenticate with. If not set, the `TILEBOX_API_KEY` environment variable is used.
</ParamField>

<ParamField path="warn_if_unauthenticated" type="bool">
  Whether to log a warning when no API key is provided for the Tilebox API URL. Defaults to `True`.
</ParamField>

<ParamField path="transport" type="Literal[&#x22;grpc&#x22;, &#x22;http1&#x22;]">
  Network transport to use for API requests. Defaults to `"grpc"`. Use `"http1"` to force the Connect protocol over HTTP/1.1 on networks that do not support gRPC over HTTP/2 correctly.
</ParamField>

If no API key is provided, the client uses anonymous open data access for public datasets.

<RequestExample>
  ```python Python theme={"system"}
  from tilebox.datasets import Client

  # read token from an environment variable
  client = Client()

  # or provide connection details directly
  client = Client(
      url="https://api.tilebox.com",
      token="YOUR_TILEBOX_API_KEY",
  )
  ```
</RequestExample>