Guide de démarrage : créer votre première clé API

Dans ce guide de démarrage, vous créez une clé API sur Studio›Studio ↗, la stockez dans une variable d'environnement et l'utilisez pour envoyer une requête de test. Comptez environ 5 minutes. Les autres guides de démarrage de Studio partent de cette clé.

• Un compte Mistral ↗ sur un plan incluant l'accès API — voir Configurer la facturation pour ajouter un moyen de paiement.
• curl, pour envoyer la requête de test.

1. Ouvrez la console Studio et accédez à Clés API (lien direct).
2. Sélectionnez Nouvelle clé.

3. Saisissez un Nom qui identifie la clé, par exemple quickstart.
4. Définissez une date d'Expiration.
5. Choisissez un Périmètre d'accès des connecteurs :
   • Connecteurs partagés uniquement : accès uniquement aux Connecteurs partagés avec l'espace de travail, et non à vos connecteurs privés.
   • Connecteurs privés et partagés : accès à la fois à vos connecteurs privés et aux Connecteurs partagés avec l'espace de travail.

6. Créez la clé, puis copiez-la et stockez-la dans un gestionnaire de mots de passe ou un coffre-fort de secrets.

export MISTRAL_API_KEY="your-api-key"

export MISTRAL_API_KEY="your-api-key"

La variable persiste pendant la session de terminal en cours.

Envoyez une requête Chat completion avec la clé :

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": "Hello, Mistral!"}]
  }'

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": "Hello, Mistral!"}]
  }'

Une réponse JSON dont choices[0].message.content contient la réponse du modèle. Le texte de la réponse varie d'une exécution à l'autre. La réponse inclut également id, created et usage.

{
  "object": "chat.completion",
  "model": "mistral-small-latest",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Hello! How can I assist you today?"
      }
    }
  ]
}

{
  "object": "chat.completion",
  "model": "mistral-small-latest",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Hello! How can I assist you today?"
      }
    }
  ]
}

Si vous obtenez {"detail":"Invalid API Key"} avec le statut HTTP 401, vérifiez que MISTRAL_API_KEY contient la clé complète, dans le terminal où vous exécutez curl.