La spec OpenAPI
Home
Tree BG 1
Tree
Tree
TreeLeaves
TreeLeaves
Cat IdleGrassGrassRockRock

Modèles

API Gestion des modèles

Lister les modèles

GET /v1/models

Lister tous les modèles disponibles pour l'utilisateur.

200

Réponse réussie

data
array<BaseModelCard|FTModelCard>
object
string

Default Value: "list"

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.list();

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.list()

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/models \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

[
  {
    "id": "<model_id>",
    "capabilities": {
      "completion_chat": true,
      "completion_fim": false,
      "function_calling": false,
      "fine_tuning": false,
      "vision": false,
      "classification": false
    },
    "job": "<job_id>",
    "root": "open-mistral-7b",
    "object": "model",
    "created": 1756746619,
    "owned_by": "<owner_id>",
    "max_context_length": 32768,
    "aliases": [],
    "TYPE": "fine-tuned",
    "archived": false
  }
]

Récupérer un modèle

GET /v1/models/{model_id}

Récupérer des informations sur un modèle.

200

Response Type
BaseModelCard|FTModelCard

Réponse réussie

BaseModelCard

{object}

Example:

payload

FTModelCard

{object}

Example:

payload

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.retrieve({
    modelId: "ft:open-mistral-7b:587a6b29:20240514:7e773925",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.retrieve(model_id="ft:open-mistral-7b:587a6b29:20240514:7e773925")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/models/{model_id} \
 -X GET \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE'

200

{
  "id": "<your_model_id>",
  "capabilities": {
    "completion_chat": true,
    "completion_fim": false,
    "function_calling": false,
    "fine_tuning": false,
    "vision": false,
    "classification": false
  },
  "job": "<job_id>",
  "root": "open-mistral-7b",
  "object": "model",
  "created": 1756746619,
  "owned_by": "<owner_id>",
  "max_context_length": 32768,
  "aliases": [],
  "TYPE": "fine-tuned",
  "archived": false
}

Supprimer un modèle

DELETE /v1/models/{model_id}

Supprimer un modèle affiné.

200

Réponse réussie

deleted
boolean

Default Value: true

Le statut de suppression.

id
*string

L'ID du modèle supprimé.

object
string

Default Value: "model"

Le type d'objet qui a été supprimé.

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.delete({
    modelId: "ft:open-mistral-7b:587a6b29:20240514:7e773925",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.delete(model_id="ft:open-mistral-7b:587a6b29:20240514:7e773925")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/models/{model_id} \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "id": "ft:open-mistral-7b:587a6b29:20240514:7e773925",
  "object": "model",
  "deleted": true
}

Mettre à jour un modèle fine-tuné

PATCH /v1/fine_tuning/models/{model_id}

Mettre à jour le nom ou la description d'un modèle.

200

Response Type
CompletionFineTunedModel|ClassifierFineTunedModel

OK

CompletionFineTunedModel

{object}

ClassifierFineTunedModel

{object}

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.update({
    modelId: "ft:open-mistral-7b:587a6b29:20240514:7e773925",
    updateFTModelIn: {},
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.update(model_id="ft:open-mistral-7b:587a6b29:20240514:7e773925")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/fine_tuning/models/{model_id} \
 -X PATCH \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{}'

200

{
  "archived": "false",
  "capabilities": {},
  "created": "1735689600",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "owned_by": "9c0ab39f-0cd0-46cd-bd30-8bf2d50be5ce",
  "root": "mistral-small-latest",
  "root_version": "v1",
  "workspace_id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

Archiver un modèle fine-tuné

POST /v1/fine_tuning/models/{model_id}/archive

Archiver un modèle fine-tuné.

200

OK

archived
boolean

Default Value: true

id
*string
object
string

Default Value: "model"

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.archive({
    modelId: "ft:open-mistral-7b:587a6b29:20240514:7e773925",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.archive(model_id="ft:open-mistral-7b:587a6b29:20240514:7e773925")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/fine_tuning/models/{model_id}/archive \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}

Désarchiver un modèle fine-tuné

DELETE /v1/fine_tuning/models/{model_id}/archive

Désarchiver un modèle fine-tuné.

200

OK

archived
boolean

Default Value: false

id
*string
object
string

Default Value: "model"

Playground

Testez les endpoints en direct

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

const mistral = new Mistral({
  apiKey: "MISTRAL_API_KEY",
});

async function run() {
  const result = await mistral.models.unarchive({
    modelId: "ft:open-mistral-7b:587a6b29:20240514:7e773925",
  });

  console.log(result);
}

run();

from mistralai.client import Mistral
import os


with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.models.unarchive(model_id="ft:open-mistral-7b:587a6b29:20240514:7e773925")

    # Handle response
    print(res)


curl https://api.mistral.ai/v1/fine_tuning/models/{model_id}/archive \
 -X DELETE \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json'

200

{
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088"
}