Questo articolo spiega come offrire la fatturazione collegata, che consente ai tuoi clienti di collegare la propria organizzazione Claude Console alla tua app. Ti fatturiamo direttamente e tu non conservi mai la loro chiave API.
La fatturazione collegata è in versione beta.
Come funziona la fatturazione collegata
Un cliente collega la propria organizzazione Claude Console alla tua piattaforma utilizzando OAuth invece di incollare una chiave API. La tua piattaforma conserva un ID di connessione, non una chiave. Esegui Claude per il cliente e ti fatturiamo direttamente.
Cosa copre la fatturazione collegata
La fatturazione collegata copre gli endpoint /v1/messages e /v1/chat/completions. Scegli chi paga per ogni richiesta: il cliente o tu.
L'API Message Batches e Claude Managed Agents non sono ancora coperti.
Le richieste pagate dal cliente non possono utilizzare l'esecuzione di codice fatturabile. L'API restituisce un errore 400, quindi invia quelle richieste come pagate dalla piattaforma.
Se solo alcune funzioni fatturano il cliente, comunica ai clienti quali sono. Non dire che tutto l'utilizzo di Claude viene fatturato alla loro organizzazione a meno che non sia vero.
La fatturazione collegata funziona solo per i clienti la cui organizzazione Claude Console è fatturata direttamente da Anthropic.
I seguenti non possono essere collegati:
I clienti che ottengono Claude tramite un provider cloud, come Bedrock, Vertex AI o Foundry, non possono collegarsi
I piani di abbonamento Claude (Pro, Max, Ultra, Team ed Enterprise) non possono essere collegati
Le organizzazioni Claude Console che pagano tramite AWS, Google Cloud o Azure Marketplace non possono utilizzare la fatturazione collegata
Le richieste vengono eseguite nell'organizzazione della tua piattaforma, non in quella del cliente. Solo la fatturazione va al cliente. Le impostazioni nell'organizzazione del cliente, come gli elenchi di indirizzi IP consentiti, le chiavi di crittografia e la conservazione dei dati, non si applicano e il contenuto viene gestito secondo l'accordo della tua organizzazione con Anthropic.
Tutti i tuoi clienti collegati condividono i limiti di velocità, l'accesso ai modelli e il livello di servizio della tua organizzazione.
Sposta i clienti dalle chiavi API
Puoi continuare a offrire chiavi API cliente insieme alla fatturazione collegata e spostare i clienti al tuo ritmo.
Per spostare un cliente:
Continua a utilizzare la chiave API del cliente finché non hai memorizzato il suo ID di connessione.
Contrassegna le richieste del cliente come pagate dal cliente.
Elimina la chiave API memorizzata e comunica al cliente che l'hai fatto.
Configura la fatturazione collegata
Per configurare la fatturazione collegata:
Crea un'app OAuth nella Claude Console.
In Cosa può fare l'app, seleziona «Fattura e collega alle organizzazioni.»
Accetta i Termini di fatturazione collegata quando richiesto.
Nella scheda Autenticazione client dell'app, configura l'autenticazione client, un account di servizio operatore e un'area di lavoro predefinita.
Aggiungi un pulsante alla tua app che avvia il collegamento, ad esempio «Collega la tua organizzazione Claude.» Utilizza i nostri esempi di branding.
Crea un profilo utente per ogni organizzazione cliente che pagherà. Ogni app consente un profilo per organizzazione cliente e un'organizzazione cliente per profilo.
Per ogni richiesta che il cliente dovrebbe pagare, invia l'ID profilo del cliente, l'intestazione beta di fatturazione e
billing_policyconbill_toimpostato suuser_profile.Pubblica l'app quando sei pronto per i clienti.
Una nuova app inizia in fase di test. Solo gli utenti di test che elenchi (fino a 10) possono collegarla, ciascuno con un limite mensile di $50 o inferiore. A meno che la tua organizzazione non abbia fatturazione fatturata, verifichi il dominio della tua app e Anthropic esamini l'app prima che sia attiva.
Regole di collegamento
Se l'organizzazione di un cliente è già collegata alla tua app tramite un altro profilo, il collegamento viene rifiutato.
Un profilo già collegato alla tua app non può essere collegato a una seconda organizzazione.
Per spostare un collegamento, scollega prima e poi collega di nuovo.
Non puoi collegare la tua app all'organizzazione Claude Console che la possiede. Per testare la fatturazione collegata come farebbe un cliente, utilizza una seconda organizzazione Claude Console che può collegarsi.
Utilizza lo stesso ID profilo utente per avviare il collegamento e per effettuare le richieste di quel cliente.
Una richiesta pagata dal cliente che nomina un profilo senza collegamento viene rifiutata con un errore 403, anche quando la Console del cliente mostra la tua piattaforma come Collegata.
Una richiesta pagata dal cliente che nomina i profili di un altro dei tuoi clienti viene fatturata a quel cliente.
Per pagare il tuo utilizzo, invia richieste senza billing_policy.
Per i passaggi completi e i valori dell'intestazione, consulta la Documentazione della piattaforma Claude.
Cosa vedono i clienti quando si collegano
Quando i clienti collegano la loro organizzazione:
Fanno clic sul pulsante che hai aggiunto alla tua app, ad esempio «Collega la tua organizzazione Claude.»
Accedono a Claude. Se la loro email appartiene a più di un'organizzazione, ne scelgono una. Se non hanno ancora un account Claude o un'organizzazione Claude Console, possono crearli qui, aggiungere crediti e quindi tornare per completare il collegamento.
Leggono come funziona la fatturazione, quindi impostano un limite di spesa mensile per la tua app o continuano senza uno. Se la tua app è ancora in fase di test, devono impostare un limite di $50 o inferiore.
Vedono una pagina di approvazione con il nome della tua app e cosa stai chiedendo. Dice che l'utilizzo viene fatturato secondo i termini di fatturazione esistenti dell'organizzazione.
Approvano e tornano alla tua app.
Solo un utente con il ruolo Admin o Billing può approvare. Scopri di più su ruoli e autorizzazioni di Claude Console. Se qualcun altro tenta di approvare, lo rinviamo alla tua app con un errore di accesso negato. Pianifica un passaggio, ad esempio un modo per passare la richiesta a un amministratore.
Un'approvazione copre l'intera organizzazione. Il collegamento appartiene all'organizzazione, quindi rimane attivo se l'approvatore se ne va. Ogni organizzazione può avere un collegamento per app.
Dopo l'approvazione, i membri Admin e Billing del cliente di solito ricevono un'email che conferma il collegamento e un'altra se si scollegano.
Come i clienti gestiscono un collegamento
I clienti gestiscono ogni collegamento nella pagina Piattaforme collegate nella Claude Console. Possono impostare un limite di spesa mensile per la tua piattaforma e scollegarsi in qualsiasi momento. Collega questa pagina dalla tua app.
Puoi anche scollegare un cliente. Un Admin nella tua organizzazione lo fa nella pagina Profili utente. Il cliente non riceve alcuna email quando lo scollegi nella Console, quindi digli tu stesso. Puoi anche scollegare un cliente dal tuo back end e Anthropic di solito gli invia un'email quando lo fai.
Puoi anche creare, elencare e aggiornare i profili dei tuoi clienti con l'API Profili utente.
Gestisci i clienti scollegati
Anthropic non invia alla tua app una notifica quando un cliente si scollega. Lo scopri quando una richiesta pagata dal cliente per quel cliente viene rifiutata con un errore 403, o dallo Stato del collegamento nella tua pagina Profili utente nella Console. Un 403 può anche significare che il cliente non può essere fatturato per un altro motivo.
Uno stato Collegato dice solo che il collegamento esiste. Una richiesta può comunque essere rifiutata, ad esempio, quando il cliente è senza crediti o ha raggiunto un limite di spesa.
Lo scollegamento di solito interrompe le nuove chiamate entro circa 10 secondi. Le chiamate già in esecuzione terminano e vengono fatturate al cliente. Mostra al cliente un messaggio chiaro e un modo per collegarsi di nuovo.
Gestisci gli errori di fatturazione
Se un cliente non può essere fatturato, rifiutiamo la richiesta. Non ti fatturiamo per quella richiesta.
Se il cliente ha raggiunto il suo limite di spesa o Anthropic attualmente non può fatturarlo (ad esempio, perché è senza crediti o sospeso), ricevi un errore 402.
Se Anthropic non può fatturare il cliente per qualsiasi altro motivo, ricevi un errore 403.
Se Anthropic non può confermare in questo momento se il cliente può essere fatturato, potresti ricevere un errore 503. Riprova con backoff e non mostrare un errore al cliente.
Un 402 significa che il cliente deve agire. Chiedigli di controllare i suoi limiti e la fatturazione nella Claude Console.
Decidi cosa succede dopo. Puoi mettere in pausa la funzione finché il cliente non agisce, oppure puoi coprire l'utilizzo tu stesso inviando di nuovo la richiesta come pagata dalla piattaforma. Se la copri, comunica al cliente per quanto tempo.
Monitora l'utilizzo e la spesa
Vedi l'utilizzo di ogni cliente e quanto ti costa. Non vedi mai quanto il cliente effettivamente paga.
Puoi monitorare l'utilizzo di ogni cliente in due modi:
Nella Claude Console: Seleziona un cliente nella pagina Profili utente per vedere il suo utilizzo. La tua spesa è solo quello che hai pagato per conto del cliente.
Con l'API: Raggruppa i risultati per
user_profile_idnell'API di analisi dell'utilizzo e dei costi, che è in versione beta. L'endpoint di utilizzo restituisce token. Sull'endpoint dei costi,amountè il tuo costo prima dei crediti ed è 0 per le richieste che il tuo cliente paga.list_amountè il costo al prezzo di listino, chiunque paghi.
Entrambe le visualizzazioni includono ogni richiesta per il cliente, chiunque abbia pagato. Mantieni il tuo record di quali richieste sono state pagate dal cliente. I dati dell'API di solito si aggiornano entro quattro ore e possono richiedere fino a 24 ore.
Domande frequenti
I clienti con requisiti HIPAA, FERPA o CMEK possono collegarsi?
Non durante la versione beta. Le richieste collegate vengono eseguite nella tua organizzazione, quindi l'accordo di associato commerciale (BAA), le chiavi di crittografia e le impostazioni di conservazione del cliente, inclusa la conservazione zero dei dati, non si applicano. Non collegare i clienti che hanno bisogno della copertura HIPAA, FERPA o CMEK.
Quali crediti possono pagare per l'utilizzo collegato?
L'utilizzo collegato viene fatturato al saldo prepagato o alla fattura del cliente. Alcuni crediti promozionali non possono essere utilizzati.
Cosa può pagare
Credito acquistato dal cliente (il suo saldo prepagato)
La fattura del cliente, se fatturata mensilmente
Correzioni di fatturazione da Anthropic
Crediti scritti nell'accordo del cliente
Cosa non può pagare
Crediti di iscrizione limitati a prodotti specifici
Crediti dai programmi partner, venture capital e startup di Anthropic (stiamo ancora implementando questo)
Se nulla sull'account del cliente può pagare, le sue richieste potrebbero essere rifiutate. Dopo che il cliente aggiunge fondi, l'acquisto potrebbe richiedere del tempo per essere applicato. Potremmo aggiornare questo elenco man mano che i nostri programmi di credito cambiano.
