# Mistral API: managing AI Studio models

This guide walks you through the complete process of creating a Mistral account, setting up billing (company details and payment method), managing spending limits, and creating API keys for integration with [AIsuru](https://www.aisuru.com/).

## **1. Registering on Mistral**

To start using Mistral AI Studio, you need to create an account on the platform:

1. Visit the [Mistral AI Studio console](https://console.mistral.ai/) and sign up;
2. If you register with an email address, you may need to verify it; check your inbox and click the confirmation link Mistral sends you to activate your account (either an OTP code or a direct sign-in link);
3. After verification, you may be asked for some additional information, such as your **full name** and acceptance of the terms of service;
4. Mistral will ask you to **create an organization** (or join an existing one, if your email domain matches a company already on the platform) and an initial **workspace**: assign a **name to your organization** — for example, your company name or an identifying project name. A default workspace with the same name will be created automatically (which you can rename later if needed).

Once registration is complete, you'll be taken to the **Mistral AI Studio dashboard**. Before using the API, you'll need to configure the **billing** section of your account.

## **2. Entering company billing details**

For correct invoicing, it's important to enter your company's details, including the VAT number:

1. In the Mistral AI Studio console, go to your organization **settings**;
2. Click your name or the **profile** icon (top right) and select **Admin Settings** from the menu: you'll be redirected to the Mistral **Admin Console** (the administrative section);
3. Make sure your organization is selected (top left), then go to the **Organization Settings** page;
4. On the organization settings page, enter your company details. In particular:
   * **Organization name**: the legal name of your company (usually pre-filled with the name you entered during registration — update it if necessary);
   * **Full address**: enter your company's billing address (street, city, postal code, country);
   * **VAT number**: if your company has a VAT number, you should find a **Tax/VAT ID** field; enter your company's VAT number **including the country prefix** (e.g. IT12345678901 for an Italian company);
5. Verify the details are correct and save your changes.

*Note: this information will be used to issue correct tax invoices for your Mistral account usage.*

## **3. Adding a payment method**

Once your company details are configured, you'll need to add a valid **payment method** to use Mistral services:

1. Open the Mistral **Admin Console** and select **Billing** from the admin menu.
2. **Add a payment card:** if this is your first time, you'll see an **Add payment method** or **Complete setup** button; click it to start the process;
3. A secure form will open where you'll enter your card details:
   * Credit or debit card number;
   * Expiration date (MM/YY format);
   * CVV/CVC code (3 or 4 security digits);
4. Complete the process by confirming the details: once added, the card will be linked to your Mistral account for future charges.

Note: currently, **only credit or debit cards are accepted**. No fixed charges will be applied immediately — you'll only pay for actual usage of the services.

### How to enable auto-recharge for Mistral APIs

To set up auto-recharge:

1. Go to the [Mistral admin console](https://admin.mistral.ai/) and click [Billing](https://admin.mistral.ai/organization/billing) in the sidebar;
2. Next to "Auto Recharge", click Update;
3. Enable the checkbox "Enable auto recharge, automatically recharging my account whenever my balance falls below a defined threshold";
4. Enter the required values:
   1. Top up my wallet with: the amount (in Euros) to add to your balance;
   2. When my balance goes below: the threshold (in Euros) at which auto-recharge kicks in;
5. Click "Enable auto recharge".

## **4. Activating billing: choosing a plan**

Mistral uses a **consumption-based** API model. After adding a payment method, you need to enable your account for API access by selecting one of the available plans.

Mistral AI Studio lets you choose between a **free plan** or a pay-as-you-go paid plan.

After adding your payment card, proceed as follows:

1. Go to the **Limits** section of the [admin console](https://admin.mistral.ai/);
2. Choose a plan:
   1. Experiment (Free) — a free plan with very restrictive usage limits and usage data sharing for training new models; ideal for initial testing;
   2. Scale (Pay-as-you-go) — a consumption-based plan with higher limits, suitable for production use. Requires payment details to be provided and will incur charges based on actual usage (per token/model, according to Mistral's pricing).
3. After selecting a plan, you may be asked to **verify your phone number**. Enter a valid number, then enter the OTP code received via SMS to confirm (this step allows Mistral to verify your account's reliability before unlocking pay-as-you-go access).

Once these steps are complete, your account will be assigned to the chosen plan!

## **5. How to monitor usage and set spending limits on Mistral AI Studio**

### **Monitoring usage**

You can monitor usage at both the organization and workspace level.

#### **Monitoring usage for a Mistral AI Studio workspace**

1. Go to [Mistral AI Studio](https://console.mistral.ai/) and click "Workspace" in the sidebar;
2. Make sure the correct workspace is selected (click the name in the top left of the popup that opens to change it);
3. Go to the "Usage" section of the popup;
4. Select the month (the current month is selected by default, but you can select any month since the workspace was created);
5. Inside this section, you can check:
   1. Total spend (broken down into categories: completion, OCR, connectors, fine tuning, audio, etc.);
   2. Day-by-day costs (total and broken down by category);
   3. Cost per category (for each category, you'll only see models actually used during the month; otherwise you'll see "No usage in \[month and year]").

#### **Monitoring organization-level API usage on Mistral AI Studio**

You can view the same information for the entire organization — aggregating all workspaces. To do so:

1. Go to the [Mistral AI admin console](https://admin.mistral.ai/) and click [Usage](https://admin.mistral.ai/organization/usage) in the sidebar;
2. As before, on this page you can select the reference month and see a breakdown of all spending aggregated in different ways (by category, by category/day, and by category/model).

### **How to set a spending limit**

Spending limits can only be set at the organization level, not per workspace. To set one:

1. Go to the [Mistral AI admin console](https://admin.mistral.ai/) and navigate to [Limits](https://admin.mistral.ai/plateforme/limits);
2. In the first section (Organization limits), enable the "Monthly API spending limit" toggle;
3. Under "Spending limit", enter the monthly spending cap in Euros and click "Update limit".

Below the Spending limit section, you'll also see your current month's usage relative to the limit you've set.

## **6. Creating an API key**

To use Mistral services with AIsuru, you need to create a Mistral **API key**:

1. In [Mistral AI Studio](https://console.mistral.ai/home), click [**API Keys**](https://console.mistral.ai/home?workspace_dialog=apiKeys) in the sidebar: the popup that opens shows the keys created within your workspace;
2. To create a new key, click "Create new key":
   1. Enter a descriptive name (optional, but recommended);
   2. Set an expiration date for the key (optional);
   3. Confirm by clicking "Create new key";
3. Click "Copy key" to copy the newly created API key and save it somewhere safe (it's only shown once at creation).

### How to manage Mistral AI Studio API keys

You can manage your keys directly from the [Mistral API keys page](https://console.mistral.ai/home?workspace_dialog=apiKeys): here you'll see a table with both active and expired keys. For each key, you can see:

* Name: the descriptive name given when the key was created;
* Key: the last four characters of the key for quick identification;
* Creation date;
* Expiration date ("Never" if not set for that key).

If you have many keys, you can use the search bar to find them by name.

### How to delete a Mistral API key

To delete a key:

1. Click the trash icon (last column);
2. Click Confirm (which will appear in place of the trash icon).

## **7. Managing workspaces**

Mistral lets you organize usage into different **workspaces**, similar to projects on other platforms. This is useful for separating activities, teams, or clients within the same organization, giving you greater control and order.

When you create your account, a default organization and an associated workspace are created automatically.

By creating additional workspaces, you can separate usage by project, internal department, or client. Each workspace maintains isolated API keys, settings, and members, allowing you to manage access and limits in a granular way within the same organization.

Note: you can manage multiple workspaces under the same organization — each will have its own independent settings (API keys, members, usage reports).

{% hint style="success" %}
If you only have one project, you can simply use the default workspace.
{% endhint %}

### Creating a new workspace

To create new workspaces, you need admin access to the [Mistral admin console](https://admin.mistral.ai/organization/):

1. Click [Workspaces](https://admin.mistral.ai/organization/workspaces) in the sidebar (this shows all your workspaces) then click the New workspace button.
2. In the menu that opens:
   1. Select an icon (an emoji from those available);
   2. Enter a name;
   3. Write a brief description (optional);
   4. If useful, enable "Add all existing organization members to this workspace";
   5. Finally, click "Create".

{% hint style="info" %}
Note: you can only archive (not delete) Mistral AI Studio workspaces.
{% endhint %}

## **8. Managing organization members and roles**

If you're working in a team, you can invite colleagues to your Mistral workspace and assign them different roles with appropriate permissions.

To add a new member to your workspace, you first need to invite them to your organization:

1. Go to the [Mistral admin console](https://admin.mistral.ai/organization) and click Members in the sidebar;
2. Click the Invite members button and in the popup that appears:
   1. Enter the team member's email (you can enter multiple addresses separated by commas);
   2. Select a role:
      1. **Admin:** full access to the organization and workspaces; can manage settings, members, billing, and has all the privileges of other roles.
      2. **Billing:** access to **billing** information and payments; can view and edit billing data, manage payment methods, and view invoices.
      3. **Member:** basic role with limited access; can use the API and view their own resources, but cannot create API keys or change critical settings.
   3. After confirming, the system will send an email with an invitation link to the specified addresses. Until the invitation is accepted, the member will appear as "pending" in the member list.
3. Depending on the role chosen, you may also need to invite the team member to individual workspaces. To do so:
   1. Go to [Mistral AI Studio](https://console.mistral.ai/) and click [Workspace](https://console.mistral.ai/home?workspace_dialog=general) in the sidebar;
   2. Select the workspace you want to work with: click the workspace name in the top left of the popup to switch;
   3. Go to Members and click Add Members:
      1. Select the organization member to add to the workspace from the dropdown;
      2. Specify the role (default is "Member", but you can also select "Admin");
      3. Finally, click "Add Member" to confirm.

At any time, you can remove members from the organization (from the [Mistral admin console](https://admin.mistral.ai/)) or from individual workspaces (within [Mistral AI Studio](https://console.mistral.ai/)).

## **9. Rate limits for Mistral API models**

Like all generative AI providers, Mistral has usage limits that can vary based on your organization's total usage and spend (or, for high-volume usage, based on commercial agreements with Mistral AI).

You can check rate limits in the [Mistral admin console](https://admin.mistral.ai/organization) (not inside Mistral AI Studio):

1. Go to the [Limits](https://admin.mistral.ai/plateforme/limits) section of the Mistral admin console;
2. In addition to checking usage and monthly spending limits, scrolling down you'll find three more sections:
   1. Rate limit per second: the limit on requests you can make per second. To simplify: 1 request = 1 message, though in practice a single message on AIsuru may consume up to 10 requests.
   2. Completion rate limits per model: here you'll find the different models (filterable with the search bar) that Mistral makes available. For each model, you'll see:
      1. Tokens per Minute (TPM): the maximum number of tokens per minute that Mistral provides for your organization for that specific model.
      2. Tokens per Month: the maximum monthly token count that Mistral provides for your organization for that specific model.
   3. Fine-tuning limits: specific limits for fine-tuning activities within Mistral AI Studio. Mistral fine-tuned models can then be used on AIsuru.

### How to increase rate limits for Mistral API models

You can request an increase in Mistral AI model usage limits by contacting Mistral's commercial support directly. You can do this by going to the [Contact us section on Mistral AI](https://mistral.ai/contact).

## **Next steps**

After completing your Mistral AI console setup:

1. Copy the API key you created;
2. Log in to your [AIsuru](https://www.aisuru.com/) dashboard;
3. Use the API key to [create a new model on the platform](/en/generative-ai/advanced/create-and-manage-model-configurations.md).


---

# 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.aisuru.com/en/generative-ai/advanced/providers-api-keys/mistral-api-managing-ai-studio-models.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.