Installer le SDK TypeScript Mistral

Pourquoi un SDK TypeScript ?

Si votre stack technique repose sur Node.js, Deno, ou Bun, le SDK TypeScript de Mistral vous permet d’intégrer les modèles directement dans vos applications JavaScript et TypeScript. Le typage statique de TypeScript apporte une sécurité supplémentaire : auto-complétion dans votre éditeur, détection d’erreurs à la compilation, et documentation inline des paramètres.

Prérequis

• Node.js 18 ou supérieur (vérifiez avec node --version)
• npm, yarn ou pnpm comme gestionnaire de paquets
• Une clé API Mistral configurée en variable d’environnement

Installation

Le SDK officiel est publié sur npm sous le nom @mistralai/mistralai :

# Avec npm
npm install @mistralai/mistralai

# Avec yarn
yarn add @mistralai/mistralai

# Avec pnpm
pnpm add @mistralai/mistralai

Configuration TypeScript

Si vous utilisez TypeScript (recommandé), assurez-vous que votre tsconfig.json est correctement configuré :

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "esModuleInterop": true,
    "strict": true,
    "outDir": "dist"
  },
  "include": ["src"]
}

Le SDK utilise des modules ES et des types TypeScript natifs. Aucune déclaration @types/ supplémentaire n’est nécessaire.

Configurer la variable d’environnement

Avec un fichier .env et dotenv

Installez dotenv pour charger vos variables depuis un fichier .env :

npm install dotenv

Créez le fichier .env à la racine de votre projet :

MISTRAL_API_KEY=votre-cle-api-ici

Ajoutez .env à votre .gitignore :

.env
.env.local

Charger la variable dans votre code

import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';

const client = new Mistral({
  apiKey: process.env.MISTRAL_API_KEY,
});

Vérifier l’installation

Créez un fichier test-mistral.ts pour valider que tout fonctionne :

import 'dotenv/config';
import { Mistral } from '@mistralai/mistralai';

async function main() {
  const client = new Mistral({
    apiKey: process.env.MISTRAL_API_KEY,
  });

  // Lister les modèles disponibles
  const models = await client.models.list();
  console.log(`Modèles disponibles : ${models.data.length}`);

  for (const model of models.data.slice(0, 5)) {
    console.log(`  - ${model.id}`);
  }
}

main().catch(console.error);

Exécutez avec tsx (recommandé pour le développement) :

npx tsx test-mistral.ts

Ou compilez puis exécutez :

npx tsc && node dist/test-mistral.js

Structure de projet recommandée

Pour un projet TypeScript utilisant le SDK Mistral :

mon-projet/
├── src/
│   ├── index.ts          # Point d'entrée
│   ├── mistral-client.ts # Initialisation du client (singleton)
│   └── utils/
├── .env                  # Variables d'environnement (git-ignoré)
├── .gitignore
├── package.json
└── tsconfig.json

Créer un module client réutilisable

Centralisez l’initialisation du client pour éviter de le créer à chaque fichier :

// src/mistral-client.ts
import { Mistral } from '@mistralai/mistralai';

if (!process.env.MISTRAL_API_KEY) {
  throw new Error('La variable MISTRAL_API_KEY est requise.');
}

export const mistral = new Mistral({
  apiKey: process.env.MISTRAL_API_KEY,
});

Puis importez-le où vous en avez besoin :

// src/index.ts
import 'dotenv/config';
import { mistral } from './mistral-client';

Points clés à retenir

• Le SDK TypeScript s’installe avec npm install @mistralai/mistralai
• L’import principal est import { Mistral } from '@mistralai/mistralai'
• Utilisez un fichier .env avec dotenv pour gérer la clé API
• Le SDK fournit des types TypeScript natifs : profitez de l’auto-complétion
• Centralisez l’initialisation du client dans un module dédié