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

Facturation Admin Bêta

(beta) API Admin - gérer les limites de dépenses, les limites de débit et les rôles. Nécessite une clé API admin.

Obtenir les limites de débit

GET /v1/admin/rate-limit#

Obtenir les limites de débit

200

OK

requests_per_second#
*integer

Nombre maximal de requêtes API autorisées par seconde.

tokens_limits_by_model#
*map<TokenLimitsByModel>

Limites de tokens pour chaque modèle.

Playground

Testez les endpoints en direct

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

200

{
  "requests_per_second": 87,
  "tokens_limits_by_model": [
    {
      "tokens_per_minute": 14,
      "tokens_per_month": 56
    }
  ]
}

Obtenir les limites de dépenses

GET /v1/admin/spend-limit#

Obtenir les limites d'utilisation, de débit et de tâches pour l'Organization.

200

OK

limits#
*LimitsContext

Playground

Testez les endpoints en direct

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

200

{
  "limits": {
    "completion": {
      "monthly_limit_reached": false
    },
    "currency": "USD",
    "last_payment_failure": false,
    "last_payment_failure_protection": null
  }
}

Mettre à jour les limites de dépenses

POST /v1/admin/spend-limit#

Mettre à jour la limite d'utilisation de l'Organization.

200

OK

limits#
*LimitsContext

Playground

Testez les endpoints en direct

curl https://api.mistral.ai/v1/admin/spend-limit \
 -X POST \
 -H 'Authorization: Bearer YOUR_APIKEY_HERE' \
 -H 'Content-Type: application/json' \
 -d '{
  "amount": 87
}'

200

{
  "limits": {
    "completion": {
      "monthly_limit_reached": false
    },
    "currency": "USD",
    "last_payment_failure": false,
    "last_payment_failure_protection": null
  }
}

Obtenir l'utilisation

GET /v1/admin/usage#

Obtenir les données d'utilisation et de coût pour l'Organization.

200

OK

audio#
*BasicModelUsageDataJSON
audio_characters#
*BasicModelUsageDataJSON
chat#
*BasicModelUsageDataJSON
completion#
*BasicModelUsageDataJSON
connectors#
*BasicModelUsageDataJSON
currency#
*string|null

Devise utilisée pour les tarifs d'utilisation.

currency_symbol#
*string|null

Symbole de devise utilisé pour les tarifs d'utilisation.

date#
*date-time

Date de référence pour la période d'utilisation.

end_date#
*date-time

Fin de la période d'utilisation.

fine_tuning#
*FineTuningDataJSON
libraries_api#
*LibrariesAPIUsageDataJSON
next_month#
*string|null

Mois suivant dans le rapport d'utilisation.

ocr#
*BasicModelUsageDataJSON
previous_month#
*string|null

Mois précédent dans le rapport d'utilisation.

prices#
*array<PriceData>|null

Tarifs utilisés pour calculer les montants d'utilisation.

start_date#
*date-time

Début de la période d'utilisation.

vibe_code#
*VibeCodeUsageDataJSON
vibe_usage#
*number

Champ d'utilisation Vibe hérité. Toujours 0 ; utilisez plutôt l'API d'utilisation Vibe.

Playground

Testez les endpoints en direct

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

200

{
  "audio": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "audio_characters": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "chat": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "completion": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "connectors": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "currency": null,
  "currency_symbol": null,
  "date": "2025-12-17T10:25:07.818693Z",
  "end_date": "2025-12-17T10:25:07.818693Z",
  "fine_tuning": {
    "storage": [
      87
    ],
    "training": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "libraries_api": {
    "audio_seconds": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "pages": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "tokens": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    }
  },
  "next_month": null,
  "ocr": {
    "models": [
      [
        [
          [
            null
          ]
        ]
      ]
    ]
  },
  "previous_month": null,
  "prices": null,
  "start_date": "2025-12-17T10:25:07.818693Z",
  "vibe_code": {
    "audio": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "audio_characters": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "completion": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "connectors": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    },
    "ocr": {
      "models": [
        [
          [
            [
              null
            ]
          ]
        ]
      ]
    }
  },
  "vibe_usage": 14
}