---
title: Démarrage rapide | RunAPI
description: Créez et gérez des clés API standard et des garde-fous avec une clé de
  gestion RunAPI.
url: https://runapi.ai/fr/docs/guides/platform-management/quickstart.md
canonical: https://runapi.ai/fr/docs/guides/platform-management/quickstart
locale: fr
---

> Version HTML: https://runapi.ai/fr/docs/guides/platform-management/quickstart
> Index du site pour les agents: https://runapi.ai/llms.txt

# Démarrage rapide

La gestion de la plateforme permet aux administrateurs de compte de créer, inspecter, mettre à jour
et révoquer des clés API standard et des garde-fous sans utiliser le tableau de bord
pour chaque modification.

## Créer une clé de gestion

Suivez le [Guide d'authentification](https://runapi.ai/fr/docs/guides/authentication.md) pour vous
connecter, puis ouvrez la page Clés de gestion et créez une clé de gestion.
Stockez-la séparément des clés d'application standard. Envoyez-la en tant que jeton
Bearer uniquement aux points de terminaison de gestion de la plateforme.

```http
Authorization: Bearer YOUR_MANAGEMENT_KEY
```

Une clé API standard ne peut pas appeler les points de terminaison de gestion des clés ou des garde-fous. Une
clé de gestion valide peut tout de même recevoir `403 Forbidden` si son propriétaire ne
dispose plus du rôle de compte requis.

## Lister les clés API standard

Utilisez `GET /api/v1/keys` pour inspecter les clés visibles par le compte de la clé de gestion :

```shell
curl "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY"
```

Utilisez les identifiants publics retournés pour les requêtes ultérieures de récupération, de mise à jour, de révocation ou d'attribution de guardrails. Ne déduisez jamais les accès à partir d'un nom de clé ou d'un jeton masqué.

## Créer et faire tourner une clé

Créez une clé d'application avec `POST /api/v1/keys`. Le secret complet
n'est retourné que dans la réponse de création ; persistez-le dans votre gestionnaire de secrets
avant de supprimer cette réponse. La rotation doit créer un remplacement,
le déployer dans l'application, vérifier le trafic, puis révoquer l'ancienne clé.

```shell
curl -X POST "https://runapi.ai/api/v1/keys" \
  -H "Authorization: Bearer YOUR_MANAGEMENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Production worker"}'
```

`credit_limit_windows` accepte toute combinaison de plafonds de dépenses glissants `1h`, `1d` et `7d`.
Si une fenêtre configurée est épuisée, les appels avec
cette clé retournent `429 Too Many Requests` jusqu'à ce que l'utilisation quitte la fenêtre.
Envoyez un objet vide lors de la mise à jour d'une clé pour effacer tous les plafonds glissants.

## Appliquer des garde-fous

Les guardrails sont des politiques de compte réutilisables pour les contrôles de modèle, de fournisseur et de dépenses. Gérez les politiques via `/api/v1/guardrails`, puis utilisez `/api/v1/guardrail_assignments` pour les attacher ou les supprimer. Traitez une assignation rejetée comme un échec de politique ou de propriété plutôt que de continuer silencieusement sans le guardrail.

## Gérer les erreurs de gestion

* `401 Unauthorized` signifie que le credential est absent, malformé,
  révoqué ou invalide.
* `403 Forbidden` signifie que la classe de credential ou le rôle du compte
  ne permet pas d'effectuer l'opération.
* `404 Not Found` signifie que la ressource demandée n'est pas visible pour
  le compte authentifié.
* `422 Unprocessable Content` signifie qu'une ou plusieurs valeurs soumises
  enfreignent une règle de ressource.

---

## Plus de ressources de RunAPI

- [Accueil](https://runapi.ai/fr/.md)
- [Catalogue de modèles](https://runapi.ai/fr/models.md)
- [Tarifs](https://runapi.ai/fr/pricing.md)
- [Fournisseurs](https://runapi.ai/fr/models)
- [Documentation](https://runapi.ai/fr/docs/guides)
- [SDK](https://runapi.ai/fr/sdk.md)
- [CLI](https://runapi.ai/fr/cli.md)
- [Serveur MCP](https://runapi.ai/fr/mcp.md)
- [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md)
- [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md)
- [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md)
- [Entreprise](https://runapi.ai/fr/contact.md)
- [Contact](https://runapi.ai/fr/contact.md)
- [Conditions](https://runapi.ai/fr/terms.md)
- [Confidentialité](https://runapi.ai/fr/privacy.md)
- [Index du site pour les agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Données structurées

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/fr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/fricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "fr",
    "@type": "TechArticle",
    "headline": "Démarrage rapide",
    "description": "Créez et gérez des clés API standard et des garde-fous avec une clé de gestion RunAPI.",
    "url": "https://runapi.ai/fr/docs/guides/platform-management/quickstart",
    "mainEntityOfPage": "https://runapi.ai/fr/docs/guides/platform-management/quickstart"
  }
]
```