Passer au contenu principal
GET
Lister les modèles et les tarifs de Devin Desktop

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, et comme volet lecture de l’API de mise à jour de la liste de modèles autorisés. 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.
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 :
Utilisez une API key d’utilisateur de service 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

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.
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

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

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 ; sa valeur est identique quelle que soit celle de filter.
object[]
Modèles disponibles pour l’appelant. Les modèles désactivés ne sont pas inclus.
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.
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.

Réponses d’erreur

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