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

# Lister les modèles et les tarifs de Devin Desktop

> Listez les modèles Devin Desktop disponibles pour votre compte, avec leurs UID, leurs noms, leurs tarifs, l’indication de leur autorisation ou non par votre Team, ainsi que la liste de modèles autorisés de la Team.

## Vue d'ensemble

Renvoie les modèles disponibles pour le compte appelant, avec les tarifs réellement facturés à ce compte, en précisant pour chacun s'il est actuellement autorisé par votre Team, ainsi que la liste de modèles autorisés enregistrée pour la Team. Utilisez-le comme source de vérité programmatique pour la tarification des modèles, plutôt que de recopier les tarifs affichés sur la [page des modèles](https://docs.devin.ai/fr/desktop/models.md), et comme volet lecture de l'[API de mise à jour de la liste de modèles autorisés](https://docs.devin.ai/fr/desktop/accounts/api-reference/update-models.md).

Les tarifs dépendent du plan et du modèle de facturation de l'appelant : deux Teams peuvent donc obtenir des valeurs différentes pour un même modèle.

> [!NOTE]
>
> Cet endpoint est en version alpha (`v2alpha`). La structure de la réponse est susceptible d'évoluer.

## Authentification

Transmettez une clé d'API dans l'en-tête `Authorization` :

```
Authorization: Bearer <api-key>
```

Utilisez une [API key d’utilisateur de service](https://docs.devin.ai/fr/api-reference/authentication.md) Devin (`cog_...`). Le rôle de l’utilisateur de service doit inclure l’autorisation **Use Devin Desktop**, et l’accès à Devin Desktop doit être activé pour le compte.

## Requête

**filter** `string`

Laissez ce paramètre non défini pour lister tous les modèles autorisés par votre plan et votre modèle de facturation, sans tenir compte des restrictions au niveau de la Team. Le champ `allowed` de chaque modèle indique si les restrictions de votre Team l’autorisent actuellement.

Définissez-le sur `allowlist` pour ne lister que les modèles autorisés par la liste de modèles autorisés de votre Team, les contrôles de l’organisation et les restrictions de groupe : la liste correspondra alors à ce que les utilisateurs voient dans le sélecteur de modèles de Devin Desktop.

**If-None-Match** `string`

Un `ETag` issu d’une réponse précédente. Renvoie `304 Not Modified` sans corps si la réponse n’a pas changé depuis.

### Exemple de requête

```bash theme={null}
curl https://server.codeium.com/api/v2alpha/models \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

Uniquement les modèles que vos utilisateurs peuvent sélectionner :

```bash theme={null}
curl "https://server.codeium.com/api/v2alpha/models?filter=allowlist" \
  -H "Authorization: Bearer $DEVIN_API_KEY"
```

## Réponse

La réponse inclut un en-tête `ETag` qui change dès qu’un élément de la réponse non filtrée est modifié : les modèles disponibles, leurs noms et leurs tarifs, leurs indicateurs `allowed` ou les champs de la liste d’autorisation. Transmettez-le dans l’en-tête `If-Match` à l’[API de mise à jour de la liste de modèles autorisés](https://docs.devin.ai/fr/desktop/accounts/api-reference/update-models.md) ; sa valeur est identique quelle que soit celle de `filter`.

**models** `object[]`

Modèles disponibles pour l'appelant. Les modèles désactivés ne sont pas inclus.

**propriétés**

**uid** `string`

Identifiant stable du modèle, par exemple `claude-sonnet-4-5`.

**name** `string`

Nom affiché dans le sélecteur de modèles.

**allowed** `boolean`

Indique si la liste de modèles autorisés de votre Team, les contrôles de l’organisation et les restrictions de groupe permettent actuellement aux utilisateurs de choisir ce modèle. Toujours `true` avec `filter=allowlist`.

**pricing\_dimensions** `object[]`

Tarifs facturés à l'appelant pour ce modèle. Vide pour les modèles sans frais.

**propriétés**

**label** `string`

Ce qui est facturé, en snake\_case : `input`, `output`, `cached_input`, `cache_read` ou `cache_write` pour la tarification par token ; pour les prix exprimés dans une unité non monétaire, la quantité facturée, par exemple `message` pour une tarification au message. Les modèles Fusion indiquent également les prix de leur sidekick avec le préfixe `sidekick_`, par exemple `sidekick_input` ou `sidekick_message`.

**unit** `string`

L'unité dans laquelle `value` est exprimée, en snake\_case, par exemple `usd`, `acus` ou `credits`.

**value** `number`

Le prix en `unit`, par `denominator`.

**denominator** `string`

La quantité à laquelle le prix s'applique, par exemple `1M tokens` ou `message`.

**info** `string`

Note facultative sur le prix, par exemple `Higher effort consumes more tokens`.

**allowed\_model\_uids** `string[]`

UID des modèles figurant dans la liste d’autorisation de votre Team, tels qu’enregistrés. Vide lorsque la Team autorise les modèles uniquement par balise.

**allowed\_model\_tags** `string[]`

Balises de modèles figurant dans la liste d’autorisation de votre Team, telles qu’enregistrées, y compris les balises de fournisseur comme `provider-anthropic`. Un modèle est autorisé si son UID figure dans la liste ou s’il porte l’une des balises listées.

### Exemple de réponse

Les modèles et les tarifs ci-dessous servent uniquement à illustrer la structure de la réponse. Appelez l'endpoint pour obtenir vos tarifs réels.

```json theme={null}
{
  "models": [
    {
      "uid": "claude-sonnet-4-5",
      "name": "Claude Sonnet 4.5",
      "allowed": true,
      "pricing_dimensions": [
        { "label": "input", "unit": "usd", "value": 3, "denominator": "1M tokens" },
        { "label": "cached_input", "unit": "usd", "value": 0.3, "denominator": "1M tokens" },
        { "label": "output", "unit": "usd", "value": 15, "denominator": "1M tokens" }
      ]
    },
    {
      "uid": "example-model",
      "name": "Example Model",
      "allowed": false,
      "pricing_dimensions": [
        { "label": "message", "unit": "acus", "value": 0.5, "denominator": "message" }
      ]
    }
  ],
  "allowed_model_uids": ["claude-sonnet-4-5"],
  "allowed_model_tags": ["provider-anthropic"]
}
```

## Réponses d'erreur

Les erreurs sont renvoyées sous la forme `{"error": "<message>"}`.

| Statut | Cause |
| - | - |
| `400` | `filter` a une valeur autre que `allowlist` |
| `401` | Clé d'API manquante ou invalide, ou clé d'API Ancien Windsurf (seules les API keys d'utilisateur de service Devin `cog_...` sont acceptées) |
| `403` | L'utilisateur associé à la clé n'a pas accès à Devin Desktop |
| `429` | Limite de débit dépassée ; attendez la durée indiquée par l'en-tête `Retry-After` avant de réessayer |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.