> 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).

# Workspace API credits add-on

Prepay for API usage with nexos.ai API credits. See pricing, how to purchase and track your balance, and how to generate or rotate your API key.

API credits let you prepay for API usage in nexos.ai. Your API requests will work as long as you have [nexos.ai credits](https://nexos.ai/blog/nexos-ai-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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FbNQdSHi7payUyxBtqpOt%2FScreenshot%202026-02-26%20at%2015.37.22.png?alt=media&amp;token=690c97c8-d261-473f-b7fb-7eb957bb6270" alt="nexos.ai billing page showing Pro plan overview, monthly seats, API add-on credits, and plan comparison options."><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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FF4IbCPhe9V5MXrBoPd2q%2F5-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=72bd13e0-3827-47a0-ad28-71bbc5f65c7a" alt="Purchase API add-on and credits modal with preset amounts and custom credit input field."><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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FjB2KkW9POcMRtVEDDtb5%2F3-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=3101a4f0-baa7-416a-b29c-a87f2d4d99be" alt="Purchase API add-on and credits modal with amount of money selected and Continue to checkout button." 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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FOGtQ1CJq8BF6iMM4nAK2%2FScreenshot%202026-02-27%20at%2015.43.52.png?alt=media&amp;token=d2b8061a-bfd2-410f-ac46-9efa6fee625a" alt="nexos.ai billing overview with API add-on and credits section highlighted, showing 14.7 credits remaining." 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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FNOog5NUMVqMIqJCIYLVd%2F2.png?alt=media&amp;token=1129d68f-5400-4e2c-8ee6-41ba3c12dbfd" alt="nexos.ai Settings API Keys tab with Generate API Key dialog and empty name field."><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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2F2uzmJq42cM5IpBLmwLBZ%2FScreenshot%202026-02-27%20at%2014.01.17.png?alt=media&amp;token=af7906f0-2423-41f4-a961-8d4a82b72c6a" alt="Generate API Key dialog showing newly created Production API key with copy and view options."><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="https://4112003433-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDcOhapgXnoeDvgGQ8Jm4%2Fuploads%2FIpaLERkrHlnSkzBUOgKG%2F1-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=9c3ad776-3099-4e94-8dd2-42db9358b035" alt="Rotate API Key dialog showing masked new key value with Close button."><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

***

## FAQs

### 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.