Passer au contenu principal

Proposer la facturation liée dans votre plateforme

Cet article explique comment proposer la facturation liée, qui permet à vos clients de lier leur propre organisation Claude Console à votre application. Nous les facturons directement, et vous ne conservez jamais leur clé API.

La facturation liée est en version bêta.

Fonctionnement de la facturation liée

Un client lie son organisation Claude Console à votre plateforme en utilisant OAuth au lieu de coller une clé API. Votre plateforme conserve un ID de connexion, pas une clé. Vous exécutez Claude pour le client, et nous le facturons directement.

Ce que couvre la facturation liée

La facturation liée couvre les points de terminaison /v1/messages et /v1/chat/completions. Vous choisissez qui paie pour chaque requête : le client ou vous.

L'API Message Batches et Claude Managed Agents ne sont pas encore couverts.

Les requêtes payées par le client ne peuvent pas utiliser l'exécution de code facturable. L'API retourne une erreur 400, donc envoyez ces requêtes comme payées par la plateforme.

Si seules certaines fonctionnalités facturent le client, informez-le lesquelles. Ne dites pas que toute utilisation de Claude est facturée à son organisation à moins que ce ne soit le cas.

La facturation liée fonctionne uniquement pour les clients dont l'organisation Claude Console est facturée directement par Anthropic.

Les éléments suivants ne peuvent pas être liés :

  • Les clients qui obtiennent Claude via un fournisseur cloud, comme Bedrock, Vertex AI ou Foundry, ne peuvent pas lier

  • Les plans d'abonnement Claude (Pro, Max, Ultra, Team et Enterprise) ne peuvent pas être liés

  • Les organisations Claude Console qui paient via la place de marché AWS, Google Cloud ou Azure ne peuvent pas utiliser la facturation liée

Les requêtes s'exécutent dans l'organisation de votre plateforme, pas celle du client. Seule la facturation va au client. Les paramètres de l'organisation du client, tels que les listes blanches IP, les clés de chiffrement et la rétention des données, ne s'appliquent pas, et le contenu est traité selon l'accord de votre organisation avec Anthropic.

Tous vos clients liés partagent les limites de débit, l'accès aux modèles et le niveau de service de votre organisation.

Migrer les clients depuis les clés API

Vous pouvez continuer à proposer les clés API des clients aux côtés de la facturation liée et les migrer à votre rythme.

Pour migrer un client :

  1. Continuez à utiliser la clé API du client jusqu'à ce que vous ayez stocké son ID de connexion.

  2. Marquez les requêtes du client comme payées par le client.

  3. Supprimez la clé API stockée et informez le client que vous l'avez fait.

Configurer la facturation liée

Pour configurer la facturation liée :

  1. Créez une application OAuth dans Claude Console.

  2. Sous Ce que l'application peut faire, sélectionnez « Facturer et lier aux organisations. »

  3. Acceptez les Conditions de facturation liée lorsque vous y êtes invité.

  4. Dans l'onglet Authentification du client de l'application, configurez l'authentification du client, un compte de service opérateur et un espace de travail par défaut.

  5. Ajoutez un bouton à votre application qui lance la liaison, comme « Lier votre organisation Claude. » Utilisez nos exemples de marque.

  6. Créez un profil utilisateur pour chaque organisation client qui paiera. Chaque application permet un profil par organisation client, et une organisation client par profil.

  7. Pour chaque requête que le client doit payer, envoyez l'ID de profil du client, l'en-tête bêta de facturation et billing_policy avec bill_to défini sur user_profile.

  8. Publiez l'application quand vous êtes prêt pour les clients.

Une nouvelle application commence en test. Seuls les utilisateurs de test que vous listez (jusqu'à 10) peuvent la lier, chacun avec une limite mensuelle de 50 $ ou moins. À moins que votre organisation n'ait une facturation facturée, vous vérifiez le domaine de votre application et Anthropic examine l'application avant qu'elle ne soit en direct.

Règles de liaison

  • Si l'organisation d'un client est déjà liée à votre application via un autre profil, la liaison est refusée.

  • Un profil déjà lié à votre application ne peut pas être lié à une deuxième organisation.

  • Pour déplacer une liaison, déliez-la d'abord, puis reliez-la.

  • Vous ne pouvez pas lier votre application à l'organisation Claude Console qui la possède. Pour tester la facturation liée comme le ferait un client, utilisez une deuxième organisation Claude Console qui peut lier.

  • Utilisez le même ID de profil utilisateur pour démarrer la liaison et pour les requêtes de ce client.

  • Une requête payée par le client qui nomme un profil sans liaison est refusée avec une erreur 403, même quand la Console du client affiche votre plateforme comme Liée.

  • Une requête payée par le client qui nomme les profils d'un autre de vos clients est facturée à ce client.

Pour payer votre propre utilisation, envoyez les requêtes sans billing_policy.

Pour les étapes complètes et les valeurs d'en-tête, consultez la Documentation de la plateforme Claude.

Ce que les clients voient quand ils lient

Quand les clients lient leur organisation :

  1. Ils cliquent sur le bouton que vous avez ajouté à votre application, comme « Lier votre organisation Claude. »

  2. Ils se connectent à Claude. Si leur e-mail appartient à plus d'une organisation, ils en choisissent une. S'ils n'ont pas encore de compte Claude ou d'organisation Claude Console, ils peuvent les créer ici, ajouter des crédits, puis revenir pour terminer la liaison.

  3. Ils lisent comment fonctionne la facturation, puis définissent une limite de dépenses mensuelles pour votre application ou continuent sans. Si votre application est encore en test, ils doivent définir une limite de 50 $ ou moins.

  4. Ils voient une page d'approbation avec le nom de votre application et ce que vous demandez. Elle indique que l'utilisation est facturée selon les conditions de facturation existantes de l'organisation.

  5. Ils approuvent et reviennent à votre application.

Seul un utilisateur ayant le rôle Admin ou Facturation peut approuver. En savoir plus sur les rôles et permissions de Claude Console. Si quelqu'un d'autre essaie d'approuver, nous le renvoie à votre application avec une erreur d'accès refusé. Planifiez un transfert, comme un moyen de transmettre la demande à un administrateur.

Une approbation couvre toute l'organisation. La liaison appartient à l'organisation, elle reste donc active si l'approbateur part. Chaque organisation peut avoir une liaison par application.

Après l'approbation, les membres Admin et Facturation du client reçoivent généralement un e-mail confirmant la liaison, et un autre s'ils se délient.

Comment les clients gèrent une liaison

Les clients gèrent chaque liaison sur la page Plateformes liées dans Claude Console. Ils peuvent définir une limite de dépenses mensuelles pour votre plateforme et se délier à tout moment. Liez à cette page depuis votre application.

Vous pouvez également délier un client. Un Admin de votre organisation le fait sur la page Profils utilisateur. Le client ne reçoit pas d'e-mail quand vous le déliez dans la Console, alors informez-le vous-même. Vous pouvez également délier un client depuis votre back-end, et Anthropic lui envoie généralement un e-mail quand vous le faites.

Vous pouvez également créer, lister et mettre à jour les profils de vos clients avec l'API Profils utilisateur.

Gérer les clients non liés

Anthropic n'envoie pas de notification à votre application quand un client se délie. Vous le découvrez quand une requête payée par le client pour ce client est refusée avec une erreur 403, ou depuis le Statut de liaison sur votre page Profils utilisateur dans la Console. Une erreur 403 peut aussi signifier que le client ne peut pas être facturé pour une autre raison.

Un statut Lié indique seulement que la liaison existe. Une requête peut toujours être refusée, par exemple, quand le client n'a plus de crédit ou a atteint une limite de dépenses.

La déliaison arrête généralement les nouveaux appels en environ 10 secondes. Les appels déjà en cours se terminent et sont facturés au client. Montrez au client un message clair et un moyen de se relier.

Gérer les erreurs de facturation

Si un client ne peut pas être facturé, nous refusons la requête. Nous ne vous facturons pas cette requête.

  • Si le client a atteint sa limite de dépenses ou qu'Anthropic ne peut pas actuellement le facturer (par exemple, parce qu'il n'a plus de crédit ou est suspendu), vous recevez une erreur 402.

  • Si Anthropic ne peut pas facturer le client pour une autre raison, vous recevez une erreur 403.

  • Si Anthropic ne peut pas confirmer maintenant si le client peut être facturé, vous pouvez recevoir une erreur 503. Réessayez avec backoff et ne montrez pas d'erreur au client.

Une erreur 402 signifie que le client doit agir. Demandez-lui de vérifier ses limites et sa facturation dans Claude Console.

Vous décidez ce qui se passe ensuite. Vous pouvez suspendre la fonctionnalité jusqu'à ce que le client agisse, ou vous pouvez couvrir l'utilisation vous-même en renvoyant la requête comme payée par la plateforme. Si vous la couvrez, informez le client pendant combien de temps.

Surveiller l'utilisation et les dépenses

Vous voyez l'utilisation de chaque client et ce qu'elle vous coûte. Vous ne voyez jamais ce que le client paie réellement.

Vous pouvez surveiller l'utilisation de chaque client de deux façons :

  • Dans Claude Console : Sélectionnez un client sur la page Profils utilisateur pour voir son utilisation. Vos dépenses sont seulement ce que vous avez payé au nom du client.

  • Avec l'API : Groupez les résultats par user_profile_id dans l'API Utilisation et Analyse des coûts, qui est en version bêta. Le point de terminaison d'utilisation retourne les jetons. Sur le point de terminaison de coût, amount est votre coût avant crédits, et il est 0 pour les requêtes que votre client paie. list_amount est le coût au prix catalogue, quel que soit qui paie.

Les deux vues incluent chaque requête pour le client, quel que soit qui a payé. Conservez votre propre enregistrement des requêtes payées par le client. Les données API se rafraîchissent généralement en quatre heures et peuvent prendre jusqu'à 24 heures.

Questions fréquemment posées

Les clients ayant des exigences HIPAA, FERPA ou CMEK peuvent-ils lier ?

Pas pendant la version bêta. Les requêtes liées s'exécutent dans votre organisation, donc l'accord d'associé commercial (BAA), les clés de chiffrement et les paramètres de rétention du client, y compris la rétention zéro, ne s'appliquent pas. Ne liez pas les clients qui ont besoin de couverture HIPAA, FERPA ou CMEK.

Quels crédits peuvent payer pour l'utilisation liée ?

L'utilisation liée est facturée au solde prépayé ou à la facture du client. Certains crédits promotionnels ne peuvent pas être utilisés.

Ce qui peut payer

  • Crédit acheté par le client (son solde prépayé)

  • La facture du client, s'il est facturé mensuellement

  • Corrections de facturation d'Anthropic

  • Crédits écrits dans l'accord du client

Ce qui ne peut pas payer

Si rien sur le compte du client ne peut payer, ses requêtes peuvent être refusées. Après que le client ajoute des fonds, l'achat peut prendre du temps à s'appliquer. Nous pouvons mettre à jour cette liste à mesure que nos programmes de crédits changent.

Avez-vous trouvé la réponse à votre question ?