> ## Documentation Index
> Fetch the complete documentation index at: https://novita.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accès aux modèles pour les clés API

L'accès aux modèles contrôle les modèles qu'une clé API individuelle peut appeler. Il ne modifie pas la gamme de modèles activés pour votre équipe : il ne fait que restreindre, au sein de cette gamme, l'ensemble des modèles qu'une clé donnée est autorisée à appeler. Les appels vers des modèles en dehors du périmètre d'accès d'une clé sont rejetés.

<Info>
  Cette fonctionnalité couvre les modèles de la gamme de produits LLM. Les capacités multimodales autonomes d'image et de vidéo ne font pas partie de la configuration de l'accès aux modèles pour le moment.
</Info>

Cas d'utilisation courants :

* **Isoler les clés par usage** : autorisez les clés de production à n'accéder qu'aux modèles stables, et les clés expérimentales à n'accéder qu'aux modèles à faible coût.
* **Limiter rapidement les risques** : lorsqu'une clé déclenche des appels inattendus à des modèles coûteux, restreignez-la à quelques modèles sûrs.
* **Collaboration externe** : pour les clés partagées avec des sous-traitants ou des partenaires, exposez uniquement les modèles convenus.

## Modes d'accès

Chaque clé API dispose de l'un des deux modes d'accès suivants :

| Mode d'accès                    | Signification                                                                                                                                                                                                                                                    |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tous les modèles activés        | Mode par défaut. La clé peut accéder à tous les modèles actuellement activés pour votre équipe, ainsi qu'aux modèles activés à l'avenir, et vous pouvez exclure des modèles spécifiques. Les futurs modèles activés restent accessibles, sauf s'ils sont exclus. |
| Modèles sélectionnés uniquement | La clé ne peut accéder qu'aux modèles que vous sélectionnez. Les modèles que votre équipe active ultérieurement ne sont pas ajoutés automatiquement — vous devez les ajouter vous-même.                                                                          |

Dans les deux modes, les modèles accessibles ne dépassent jamais la gamme de modèles activés de votre équipe et n'incluent jamais les modèles qui ont été mis hors ligne.

* Tous les modèles activés : modèles accessibles = modèles activés de l'équipe (y compris les futurs modèles) − modèles exclus.
* Modèles sélectionnés uniquement : modèles accessibles = modèles sélectionnés (intersectés avec les modèles activés de l'équipe).

## Configurer l'accès aux modèles

<Note>
  Seuls les administrateurs d'équipe peuvent configurer l'accès aux modèles pour une clé API. Les membres Developer et Basic voient un résumé en lecture seule pour les clés auxquelles ils peuvent accéder, mais ne peuvent pas le modifier ; les membres Billing ne voient pas du tout l'accès aux modèles.
</Note>

<Steps>
  <Step title="Ouvrir Key Management">
    Accédez à [Key Management](https://novita.ai/settings/key-management) et trouvez la clé API que vous souhaitez configurer.
  </Step>

  <Step title="Ouvrir les paramètres d'accès aux modèles">
    Lors de la création ou de la modification de la clé, ouvrez la section **Accès aux modèles**.
  </Step>

  <Step title="Choisir un mode d'accès">
    Sélectionnez **Tous les modèles activés** ou **Modèles sélectionnés uniquement** :

    * Pour **Tous les modèles activés**, ajoutez les modèles que vous souhaitez bloquer sous **Modèles exclus**.
    * Pour **Modèles sélectionnés uniquement**, ajoutez au moins un modèle sous **Modèles accessibles**.
  </Step>

  <Step title="Enregistrer">
    Après l'enregistrement, les nouveaux paramètres d'accès aux modèles peuvent prendre un certain temps avant de prendre effet.
  </Step>
</Steps>

<Tip>
  Lors de la création d'une nouvelle clé ou de la modification d'une clé existante, vous pouvez réutiliser les paramètres d'une autre clé au sein de la même équipe avec **Copier la configuration** et **Coller la configuration**. Après le collage, vous pouvez enregistrer directement ou ajuster d'abord les paramètres.
</Tip>

## Lorsqu'un modèle est mis hors ligne

Si un modèle est mis hors ligne par la plateforme, il quitte l'ensemble des modèles disponibles :

* Tous les appels vers ce modèle renvoient immédiatement une réponse « modèle indisponible ».
* Si la configuration enregistrée d'une clé contient encore le modèle hors ligne, il reste visible mais grisé. Vous devez le supprimer avant d'enregistrer, sinon la configuration ne peut pas être enregistrée.

## Lorsqu'un appel est rejeté

Lorsqu'une clé API appelle un modèle en dehors de son périmètre d'accès, l'appel renvoie HTTP 403 avec le code d'erreur `model_access_denied`, indiquant que la clé ne peut pas accéder à ce modèle. Contactez l'administrateur de votre équipe pour ajuster l'accès aux modèles de la clé. Consultez également [Codes d'erreur courants](/docs/fr/guides/error).

Pour gérer l'accès aux modèles d'une clé par programmation, consultez [Get API Key Model Access Policy](/docs/fr/api-reference/key-get-model-access-policy).