> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/workspace/settings/organization/billing/api-credits-add-on.md).

# 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:

* To use the API, you must be on a paid plan and have API credits available in your balance. 
* API credits are purchased separately.

### 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 as soon as I’m on a paid plan?

Not yet. You must separately purchase API credits before the API works.

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

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

#### 3. **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.

#### 4. **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.

#### 5. **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.

#### 6. **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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.