# L'API de Mistral et Studio : clé, premier appel, prix, agents

> L'API de Mistral : créer une clé dans Studio, premier appel en curl, Python et TypeScript, choix du modèle, réflexion, prix au jeton et agents.

- Niveau : Expert
- Thème : Les outils expliqués
- Durée : 16 minutes
- Systèmes : Mac, Windows, Linux, Navigateur
- Disponible en France : L'API s'utilise depuis la France et héberge les données dans l'Union européenne par défaut ; un point d'accès américain existe sur demande explicite. Les prix sont affichés en dollars, avec une bascule en euros sur la page de la documentation. (https://help.mistral.ai/fr/articles/347629-ou-stockez-vous-mes-donnees-ou-celles-de-mon-organisation, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/mistral-api-et-studio/

L'API de Mistral permet d'appeler ses modèles depuis un programme : un site, un script, un agent. On l'administre dans Studio, la console des développeurs, à l'adresse console.mistral.ai. Studio s'appelait autrefois « la Plateforme » ; certaines pages de la documentation gardent ce nom.

## Comment ça marche

![Le trajet d'un appel : la clé vient de Studio, la requête part vers api.mistral.ai, la réponse revient avec le décompte des jetons. D'après la documentation de Mistral, lue le 17 novembre 2026.](https://quelleia.com/guides/mistral-api-et-studio/trajet-d-un-appel.svg)

*Le trajet d'un appel : la clé vient de Studio, la requête part vers api.mistral.ai, la réponse revient avec le décompte des jetons. D'après la documentation de Mistral, lue le 17 novembre 2026.*

Votre programme envoie une requête HTTP à `https://api.mistral.ai/v1/…` avec votre clé dans l'en-tête `Authorization`. Il précise le modèle et la conversation. La réponse contient le texte du modèle et un champ `usage` qui compte les jetons lus et écrits. Mistral facture ces jetons au prix du modèle choisi.

La formule Mistral est commune à Vibe, Studio et l'API. Chaque formule comprend un usage mensuel inclus, partagé entre Studio, l'API et Vibe Code. Au-delà, le paiement à l'usage, réglé d'avance par des crédits, prend le relais s'il est activé dans **Admin Panel**, puis **Subscription**. Sinon, les appels s'arrêtent jusqu'à la période suivante.

## Créer une clé

1. Ouvrez [console.mistral.ai](https://console.mistral.ai) et allez dans **API Keys**. Votre compte doit avoir une formule qui donne accès à l'API ; ajoutez au besoin un moyen de paiement.
2. Cliquez sur **New key**.
3. Donnez-lui un nom (par exemple `essai`) et une date d'expiration.
4. Choisissez sa portée sur les connecteurs : connecteurs partagés seulement, ou aussi vos connecteurs privés.
5. Créez la clé et copiez-la aussitôt : elle ne s'affiche qu'une fois. Rangez-la dans un gestionnaire de mots de passe.
6. Placez-la dans une variable d'environnement, que lisent les exemples et les kits de développement (SDK) de Mistral :

```bash
export MISTRAL_API_KEY="votre-clé"
```

> **Bon à savoir.** Mistral conseille de fixer une date d'expiration à chaque clé et d'en changer régulièrement : créez la nouvelle, basculez votre code, puis supprimez l'ancienne. Une erreur `401` avec `{"detail":"Invalid API Key"}` signifie en général que la variable ne contient pas la clé entière.

## Le premier appel

Avec curl, sans rien installer :

```bash
curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-small-latest",
    "messages": [{"role": "user", "content": "Explique en une phrase ce qu’est une clé d’API."}]
  }'
```

La réponse arrive en JSON, avec le texte dans `choices[0].message.content`.

En Python, la documentation crée un projet avec `uv`, installe le kit officiel, puis place le code dans un fichier `quickstart.py` :

```bash
uv init premier-appel --python 3.12 && cd premier-appel
uv add mistralai
```

```python
import os
from mistralai.client import Mistral

client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
reponse = client.chat.complete(
    model="mistral-small-latest",
    messages=[{"role": "user", "content": "Explique en une phrase ce qu’est une clé d’API."}],
)
print(reponse.choices[0].message.content)
```

```bash
uv run quickstart.py
```

En TypeScript, le paquet est `@mistralai/mistralai` :

```typescript
import { Mistral } from "@mistralai/mistralai";

const client = new Mistral({ apiKey: process.env.MISTRAL_API_KEY });
const reponse = await client.chat.complete({
  model: "mistral-small-latest",
  messages: [{ role: "user", content: "Explique en une phrase ce qu’est une clé d’API." }],
});
console.log(reponse.choices[0].message.content);
```

> **Bon à savoir.** Certaines fonctions récentes, dont `reasoning_effort` en Python, demandent la version 2 du kit (`mistralai>=2`). La documentation donne un guide de migration depuis la version 1.

## Choisir le modèle

Les identifiants en `-latest` suivent la dernière version d'une famille ; un identifiant daté (`mistral-small-2603`) fige la version, ce qui évite qu'une mise à jour change le comportement de votre application. Les modèles généralistes que la page des prix listait le 17 novembre 2026, par million de jetons :

| Modèle | Identifiant | Entrée | Sortie |
| --- | --- | --- | --- |
| Mistral Large 4 | `mistral-large-4` | 0,7 $ (0,07 $ en cache) | 2,1 $ |
| Mistral Small 4 | `mistral-small-2603` | 0,15 $ | 0,6 $ |
| Ministral 3 14B | `ministral-14b-2512` | 0,2 $ | 0,2 $ |
| Ministral 3 8B | `ministral-8b-2512` | 0,15 $ | 0,15 $ |
| Ministral 3 3B | `ministral-3b-2512` | 0,1 $ | 0,1 $ |

La même page vend des modèles d'autres éditeurs (GLM 5.3 et GLM 5.3 Flash de Z.ai, DeepSeek V4.1 Flash), et des modèles spécialisés : OCR à 4 $ les 1 000 pages pour OCR 4.1, Codestral pour le code, Voxtral pour la voix, des modèles d'embeddings et de modération. Mistral Medium 3.5 (1,5 $ et 7,5 $) n'y figure plus : sa fiche le marque « Deprecated » depuis le 31 octobre 2026, avec un retrait prévu le 30 avril 2027, et désigne Mistral Large 4 pour le remplacer.

![Page API pricing de la documentation de Mistral : champ de recherche, case Regional inference, onglets Standard, Batch, Priority, choix USD ou EUR, puis la rubrique Generalist models avec les cartes des modèles.](https://quelleia.com/guides/mistral-api-et-studio/tarifs-api.webp)

*La page des prix de l'API dans la documentation de Mistral, avec ses bascules Standard, Batch et Priority, et USD ou EUR (capture du 17 novembre 2026, docs.mistral.ai). Image : Mistral AI.*

Trois autres leviers jouent sur la facture. Le **cache** facture dix fois moins cher le début de requête déjà vu, sur Large 4. Le **traitement par lots** (Batch) envoie un fichier de requêtes à traiter en différé. **Priority Tier** place les requêtes admissibles dans une file prioritaire, pour un accès plus régulier aux serveurs partagés. La page des prix bascule entre ces trois tarifs, et entre dollars et euros.

## La réflexion et les autres paramètres

Mistral Large 4, Mistral Small 4 et Mistral Medium 3.5 savent raisonner avant de répondre. Le paramètre `reasoning_effort` règle cet effort. Pour Large 4, il accepte `low`, `medium` et `high` (valeur par défaut, conseillée pour les agents) ; pour Small 4 et Medium 3.5, la documentation décrit `none` et `high`.

```bash
curl https://api.mistral.ai/v1/chat/completions \
  -H "Authorization: Bearer $MISTRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mistral-large-4",
    "reasoning_effort": "medium",
    "messages": [{"role": "user", "content": "Un train part à 14 h 10 et roule 2 h 55. À quelle heure arrive-t-il ?"}]
  }'
```

La réponse contient alors un morceau de réflexion, puis la réponse. Les jetons de réflexion sont facturés comme des jetons de sortie. Pour Large 4, la carte du modèle recommande `temperature=1.0` quel que soit l'effort, et rappelle que `max_completion_tokens` compte les jetons de réflexion avec ceux de la réponse.

Les autres fonctions courantes de l'API :

- **Flux** : `client.chat.stream(…)` renvoie la réponse morceau par morceau, pour l'afficher pendant qu'elle s'écrit.
- **Sortie en JSON** : `"response_format": {"type": "json_object"}` force une réponse en JSON ; un schéma précis passe par les « Structured Outputs ».
- **Appel de fonctions** : vous décrivez vos fonctions, le modèle dit laquelle appeler et avec quels arguments, votre code l'exécute et renvoie le résultat.
- **Images** : Large 4, Small 4 et les Ministral 3 acceptent des images en entrée.

## Les agents côté API

Mistral propose deux générations d'agents, et sa documentation pousse vers la nouvelle.

L'**API Agents et Conversations** (`/v1/agents`, `/v1/conversations`) enregistre un agent avec ses consignes et ses outils intégrés : recherche web, interpréteur de code, génération d'images, recherche dans une bibliothèque de documents, connecteurs MCP. La documentation prévient qu'elle « is about to be deprecated ».

Les **Managed Agents**, avec le kit `mistralai-agents`, sont en préversion publique. L'agent tourne d'abord dans votre propre processus, puis se déploie sur vos serveurs (`agents serve`) ou chez Mistral (`agents deploy`). Mistral y ajoute la reprise après une panne, des bacs à sable pour exécuter des commandes, des secrets gardés hors du code et des traces de chaque étape. Pour démarrer :

```bash
uvx --python 3.12 --from mistralai-agents agents init mon-agent
cd mon-agent
uv run --env-file .env python main.py
```

```python
from mistralai import agents

@agents.tool
async def meteo(ville: str) -> dict[str, str]:
    """Météo d'une ville."""
    return {"meteo": f"ensoleillé à {ville}"}

agent = agents.Agent(
    model="mistral-large-4",
    name="mon-agent",
    instructions="Tu réponds en français et tu donnes la météo d'une ville.",
    tools=[meteo],
)
```

La commande `uv run --env-file .env agents chat` ouvre ensuite une conversation avec l'agent dans le terminal. Le guide [C'est quoi un agent](https://quelleia.com/guides/c-est-quoi-un-agent/) explique la boucle modèle, outil, résultat.

Pour situer les modèles dans les tâches d'agent, d'après les mesures que relève QUELLE IA :

**Le haut du classement Agents**

1. [GPT-6 Astra](https://quelleia.com/modeles/gpt-6-astra/) : 100,3 (OpenAI)
2. [Claude Opus 5.5](https://quelleia.com/modeles/claude-opus-5-5/) : 100,1 (Anthropic)
3. [Gemini 4 Argon](https://quelleia.com/modeles/gemini-4-argon/) : 99,3 (Google DeepMind)
4. [Claude Fable 5.1](https://quelleia.com/modeles/claude-fable-5-1/) : 97,4 (Anthropic)
5. [GPT-6.1 Sol](https://quelleia.com/modeles/gpt-6-1-sol/) : 96,0 (OpenAI)

Score Agents, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.
[Classement Agents des modèles de langage](https://quelleia.com/classement/agents/)

## Studio vu depuis un agent : le serveur MCP

Mistral publie aussi un serveur MCP qui expose votre espace Studio comme une série d'outils, à l'adresse `https://api.mistral.ai/mcp`, avec la clé d'API en en-tête. Un agent de code peut ainsi consulter et piloter votre espace. Avec Vibe :

```bash
vibe mcp add mistralai --url https://api.mistral.ai/mcp --transport streamable-http --api-key-env MISTRAL_API_KEY
```

La clé est liée à un espace de travail : l'agent obtient exactement les droits de cette clé.

## Données et confidentialité

En mode gratuit, Mistral peut utiliser les entrées et sorties de l'API pour entraîner ses modèles ; vous pouvez vous y opposer. Dans le panneau d'administration, ouvrez **Privacy**, puis coupez **Anonymous improvement data**. Ce réglage est indépendant de celui de Vibe : il faut faire les deux. Les données sont hébergées dans l'Union européenne par défaut, sauf si vous appelez explicitement le point d'accès américain.

## Pour aller plus loin

- [Mistral large 4](https://quelleia.com/modeles/mistral-large-4/)
- [Mistral ai](https://quelleia.com/editeurs/mistral-ai/)
- [Vibe (ex-Le Chat)](https://quelleia.com/abonnements/vibe/)
- [La démarche](https://quelleia.com/demarche/)
- [Classement général](https://quelleia.com/classement/)
- [Mistral Large 4 expliqué : taille, licence, prix et usage](https://quelleia.com/guides/mistral-large-4.md) (guide, amateur)
- [Coder avec Vibe de Mistral : terminal, VS Code et Vibe Desktop](https://quelleia.com/guides/mistral-vibe.md) (guide, amateur)
- [Voxtral de Mistral : transcrire et faire parler une voix](https://quelleia.com/guides/mistral-voxtral.md) (guide, amateur)
- [Modèle de réflexion : penser avant de répondre](https://quelleia.com/guides/modele-de-reflexion.md) (guide, débutant)
- [MCP : brancher des outils dans Claude, ChatGPT ou un agent](https://quelleia.com/guides/mcp.md) (guide, amateur)
- [C'est quoi un agent d'IA ? La boucle expliquée](https://quelleia.com/guides/c-est-quoi-un-agent.md) (guide, débutant)

## Sources

- https://docs.mistral.ai/getting-started/quickstarts/studio/activate-and-generate-api-key (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/quickstarts/send-your-first-request (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/pricing (lue le 17 novembre 2026)
- https://docs.mistral.ai/models (lue le 17 novembre 2026)
- https://docs.mistral.ai/models/mistral-large-4-0 (lue le 17 novembre 2026)
- https://docs.mistral.ai/models/mistral-medium-3-5-26-04 (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/conversations/reasoning (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/conversations/chat-completion (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/conversations/structured-output/json_mode (lue le 17 novembre 2026)
- https://docs.mistral.ai/admin/billing-usage/subscriptions (lue le 17 novembre 2026)
- https://docs.mistral.ai/studio/agents/overview (lue le 17 novembre 2026)
- https://docs.mistral.ai/studio/agents/getting-started/quickstart (lue le 17 novembre 2026)
- https://docs.mistral.ai/studio/agents/agent-tools (lue le 17 novembre 2026)
- https://docs.mistral.ai/resources/mcp (lue le 17 novembre 2026)
- https://huggingface.co/mistralai/Mistral-Large-4-1T-A52B (lue le 17 novembre 2026)
- https://docs.mistral.ai/inference/priority-tier (lue le 17 novembre 2026)
- https://help.mistral.ai/fr/articles/455207-puis-je-m-opposer-a-l-utilisation-de-mes-donnees-d-entree-ou-de-sortie-pour-l-entrainement (lue le 17 novembre 2026)
- https://help.mistral.ai/fr/articles/347629-ou-stockez-vous-mes-donnees-ou-celles-de-mon-organisation (lue le 17 novembre 2026)
