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

# API Key

> Create the key that authenticates hosted Nori requests.

This key authenticates requests to **hosted Nori**. Running Nori on your own
machine with `synthefy-nori` needs no key at all — see
[Installation](/setup/installation).

<a id="api-key-for-synthefy-nori" />

<a id="api-key-for-synthefy-nori-tabular" />

<CardGroup cols={2}>
  <Card title="Treat it like a password" icon="lock">
    Anyone who has your key can spend your usage credits.
  </Card>

  <Card title="Where to find it" icon="key">
    The [**API Keys** page](https://console.synthefy.com/api-keys) in the
    Synthefy Console. Copy the whole key, with no leading or trailing spaces.
  </Card>
</CardGroup>

<Note>
  **One key at a time.** You can have exactly one Nori key. If one already
  exists, the create button is replaced by your active key. To rotate, delete
  the existing key first, then create a new one — deleting revokes it
  immediately.
</Note>

## Create your key

<Steps>
  <Step title="Open the API Keys page">
    Sign in to the Synthefy Console and open the [**API Keys**
    page](https://console.synthefy.com/api-keys).
  </Step>

  <Step title="Find the Synthefy Nori section">
    At the top of the page, find the **Synthefy Nori** section, subtitled
    "Manage the API key for the Synthefy Nori model".
  </Step>

  <Step title="Subscribe">
    An active subscription is required before you can create a key. If you're
    not subscribed yet, the **Create Synthefy Nori key** button is disabled —
    click **Subscribe**, complete checkout in the Stripe tab that opens, then
    return to the console. The page refreshes and unlocks key creation.
  </Step>

  <Step title="Create the key">
    In the **Synthefy Nori access** card, click **Create Synthefy Nori key**.
  </Step>

  <Step title="Copy it before closing the dialog">
    A dialog titled **API key created successfully** shows the full key. Copy it
    and store it somewhere safe, such as a password manager or secret store.
  </Step>
</Steps>

<Warning>
  **The key is shown only once, at creation.** If you lose it, delete the key
  and create a new one.
</Warning>

Afterwards the section shows an active-key card with the model name, a masked
key identifier, your rate limits, and **Delete key** / **Manage subscription**
buttons.

## Rate limits

| Limit       | Value                   |
| ----------- | ----------------------- |
| Rate limit  | 50 requests per minute  |
| Usage limit | 10,000 requests per day |

## Using your key

Pass it to the client explicitly:

```python theme={null}
import os
from synthefy import SynthefyNoriClient

client = SynthefyNoriClient(api_key=os.environ["SYNTHEFY_NORI_API_KEY"],
                            model="nori-30m")
```

Or set it once in your environment and omit the argument:

```bash theme={null}
export SYNTHEFY_NORI_API_KEY=your_api_key
```

For a full request and response example, including cURL, see the
[Quickstart](/nori/quickstart#api).

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/nori/quickstart#api">
    Make your first request with the key you just created.
  </Card>

  <Card title="Python Client" icon="plug" href="/nori/client">
    Auth, retries and DataFrames handled for you.
  </Card>
</CardGroup>