> See the full index of documentation pages at https://docs.zettabyte.com/llms.txt.

# API keys

> Create an API key on the console's API Keys page and read the key list.

Source: https://docs.zettabyte.com/docs/accounts-and-roles/api-keys

Last updated: 2026-11-05

Create an API key on the [**API Keys**](https://console.zettabyte.com/API-key/list) page and read its limits in the key list. API keys authenticate calls to zSTUDIO's model API. The page is in both workspaces. The console's platform switcher lists them as **AI Infrastructure Rental** (zCLOUD) and **MaaS via API** (zSTUDIO).

## Create a key

> [!WARNING]
> **The key is shown once**
> The console shows the complete key once, in the **Copy API Keys** dialog at creation. Copy it then and store it securely; treat it like a password.

1. Open [**API Keys**](https://console.zettabyte.com/API-key/list) and select **Create API Keys**.
2. In **API Keys Name**, enter a name for the key.
3. Optionally, set **RPM** (requests per minute) and **TPM** (tokens per minute). The fields open filled with default values, and the form shows those defaults below the fields.
4. Under **API Keys Validity**, select **No Expiration** or **Customized Validity Period**.
5. Select **Create API Keys**. The **Copy API Keys** dialog opens with the key: select **Copy** and store the key securely.

The new key is listed on the **API Keys** page, with its own **Rate Limiting** value.

**Permission Settings** shows two boxes, **Inference Service: Reading** and **Inference Service: Write/Execute**. The boxes can't be selected.

You can create more than one API key, and each shows its own rate limit and recent usage time. A key isn't tied to a model: the model is set in each request.

## View your keys

Use the **API Keys** page to find a key and read its limits.

The list has these columns: **Name**, **Secret Key**, **Status**, **Rate Limiting**, **Belonging Users**, **Creation Time** and **Recent Usage Time**. After creation, the **Secret Key** column shows a masked value.

The **Rate Limiting** column shows each key's limits as RPM / TPM: requests per minute and tokens per minute.

## Use a key with zSTUDIO

A key authenticates a call to zSTUDIO's model API: see the [zSTUDIO API reference](https://docs.zettabyte.com/docs/zstudio/reference/overview) for how a call authenticates and where it goes, [the quickstart](https://docs.zettabyte.com/docs/zstudio/introduction/quickstart) for a first call from code, or [Connect an app or tool to zSTUDIO](https://docs.zettabyte.com/docs/zstudio/guides/connect-an-app-or-tool) for a settings screen.

## Next steps

- [zSTUDIO API errors](https://docs.zettabyte.com/docs/zstudio/troubleshooting/errors): look up a failed call by its status or message.
- [Token usage](https://docs.zettabyte.com/docs/zstudio/guides/token-usage): calls and tokens by API key.
