# API credits add-on

## API credits - purchase and usage

API credits let you prepay for API usage in nexos.ai. Your API requests will work as long as you have credits in your balance.

### Before you start

To use the API, you need to meet these requirements:

* You must be on the **Pro plan** (Trial users do not have API access).
* You must purchase API credits before you can use the API (Pro users do not have API access until credits are purchased).

### How pricing works

* API credits are prepaid.
* 1€ = 1 credit.
* There are no hard limits. Usage continues until your credit balance reaches zero.

### How to purchase API credits

{% stepper %}
{% step %}

### Open Billing

Go to your workspace Billing area.

<figure><img src="/files/zhDynneGs6XIQgg8196Y" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose “Purchase API credits”

In Billing, find the “API add-on & credits” section and select the option to purchase credits.

<figure><img src="/files/dJ2uFNQyKeFYmBZBwlZA" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Select how many credits to buy

Choose the number of credits you want to purchase. The total cost will match the number of credits (1€ per credit).

<figure><img src="/files/wv1hWw4GmOIKvns8KpD1" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Complete payment

Follow the checkout steps to complete your purchase.
{% endstep %}

{% step %}

### Confirm your updated balance

After payment, your API credit balance will be updated in Billing, and you will be able to see your remaining balance there.

The API works as long as your balance has credits.&#x20;

<figure><img src="/files/Gax8ydMMszPVGOg8H6KD" alt="" width="563"><figcaption></figcaption></figure>

{% endstep %}
{% endstepper %}

### How to generate your API key

You need an API key to make API requests from your own tool or app.

{% stepper %}
{% step %}

### Create your API key

Open **Settings**, then go to the **API Keys** sections.
{% endstep %}

{% step %}

### Generate a key

Click **Generate API key**.

<figure><img src="/files/JiDlWqmwi6cF98TaZrJp" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Name the key and generate

Enter a name so you can recognize it later (for example, “Production” or “My app”), then click **Generate**.
{% endstep %}

{% step %}

### Save your API Key

After you click **Generate**, a pop up will appear showing your API key. Copy it and save it somewhere secure right away. You will not be able to see the full key again after you close the pop up.

<figure><img src="/files/HNXAb3K55NnHGAy1i4Z2" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Rotate API key

If you think your API key was shared by mistake, or you just want to replace it for security reasons, you can **rotate** the key. Rotating means the old key will stop working and a new key will be created in its place.

To rotate a key, go to the **API Keys** tab in Settings, find the key you want to change, and choose **Rotate**. A confirmation window will appear explaining that the current key will be permanently disabled and replaced with a new one.

<figure><img src="/files/OsOJbVG69ftyRN7hpN4S" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

### Common questions

#### 1. Do I get API access on Trial?

No. Trial users do not have API access.

#### 2. Do I get API access as soon as I’m on Pro?

Not yet. Pro is required, but you must also purchase API credits before the API works.

#### 3. What happens when I run out of credits?

API usage stops when your balance reaches zero. Add more credits to continue.

#### 4. **Can I see my full API key again later?**

No. For security, the full key is only shown once when you generate it. Make sure you copy and save it.

#### 5. **What should I do if I think my API key is leaked?**

Rotate the key right away, then update any apps or scripts to use the new key.

#### 6. **Will rotating an API key break my integrations?**

Yes, anything using the old key will stop working until you replace it with the new one.

#### 7. **Can I have more than one API key?**

If your workspace supports multiple keys, you can create separate keys for different tools (for example, one for production and one for testing).

### Tips

* If you plan to run large jobs, purchase enough credits to avoid interruptions.
* Keep an eye on your credit balance in Billing so your API workflows do not stop unexpectedly.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexos.ai/workspace/settings/organization/billing/api-credits-add-on.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.