Zum Hauptinhalt springen

Verknüpfte Abrechnung in Ihrer Plattform anbieten

Dieser Artikel erklärt, wie Sie verknüpfte Abrechnung anbieten, mit der Ihre Kunden ihre eigene Claude Console-Organisation mit Ihrer App verknüpfen können. Wir berechnen ihnen direkt ab, und Sie halten niemals ihren API-Schlüssel.

Verknüpfte Abrechnung befindet sich in der Beta-Phase.

So funktioniert verknüpfte Abrechnung

Ein Kunde verknüpft seine Claude Console-Organisation mit Ihrer Plattform über OAuth, anstatt einen API-Schlüssel einzufügen. Ihre Plattform speichert eine Verbindungs-ID, keinen Schlüssel. Sie führen Claude für den Kunden aus, und wir berechnen dem Kunden direkt ab.

Was verknüpfte Abrechnung abdeckt

Verknüpfte Abrechnung deckt die Endpunkte /v1/messages und /v1/chat/completions ab. Sie wählen für jede Anfrage, wer zahlt: der Kunde oder Sie.

Die Message Batches API und Claude Managed Agents sind noch nicht abgedeckt.

Kundengebührenpflichtige Anfragen können keine abrechenbare Code-Ausführung verwenden. Die API gibt einen 400-Fehler zurück, daher senden Sie diese Anfragen als plattformgebührenpflichtig.

Wenn nur einige Funktionen dem Kunden in Rechnung gestellt werden, teilen Sie den Kunden mit, welche. Sagen Sie nicht, dass die gesamte Claude-Nutzung ihrer Organisation in Rechnung gestellt wird, es sei denn, das ist der Fall.

Verknüpfte Abrechnung funktioniert nur für Kunden, deren Claude Console-Organisation direkt von Anthropic abgerechnet wird.

Folgende können nicht verknüpft werden:

  • Kunden, die Claude über einen Cloud-Anbieter wie Bedrock, Vertex AI oder Foundry erhalten, können nicht verknüpfen

  • Claude-Abonnementpläne (Pro, Max, Ultra, Team und Enterprise) können nicht verknüpft werden

  • Claude Console-Organisationen, die über den AWS-, Google Cloud- oder Azure-Marketplace zahlen, können keine verknüpfte Abrechnung verwenden

Anfragen werden in der Organisation Ihrer Plattform ausgeführt, nicht in der des Kunden. Nur die Abrechnung geht an den Kunden. Einstellungen in der Organisation des Kunden, wie IP-Zulassungslisten, Verschlüsselungsschlüssel und Datenspeicherung, gelten nicht, und Inhalte werden gemäß Ihrer Vereinbarung mit Anthropic behandelt.

Alle Ihre verknüpften Kunden teilen die Ratenlimits, den Modellzugriff und die Service-Stufe Ihrer Organisation.

Kunden von API-Schlüsseln migrieren

Sie können weiterhin Kunden-API-Schlüssel neben verknüpfter Abrechnung anbieten und Kunden in Ihrem eigenen Tempo migrieren.

So migrieren Sie einen Kunden:

  1. Verwenden Sie weiterhin den API-Schlüssel des Kunden, bis Sie seine Verbindungs-ID gespeichert haben.

  2. Markieren Sie die Anfragen des Kunden als kundengebührenpflichtig.

  3. Löschen Sie den gespeicherten API-Schlüssel und teilen Sie dem Kunden mit, dass Sie dies getan haben.

Verknüpfte Abrechnung einrichten

So richten Sie verknüpfte Abrechnung ein:

  1. Erstellen Sie eine OAuth-App in der Claude Console.

  2. Wählen Sie unter „Was die App kann“ die Option „Abrechnung und Verknüpfung mit Organisationen.“

  3. Akzeptieren Sie die Bedingungen für verknüpfte Abrechnung, wenn Sie dazu aufgefordert werden.

  4. Richten Sie auf der Registerkarte „Clientauthentifizierung“ der App die Clientauthentifizierung, ein Operator-Dienstkonto und einen Standard-Arbeitsbereich ein.

  5. Fügen Sie Ihrer App eine Schaltfläche hinzu, die die Verknüpfung startet, z. B. „Verknüpfen Sie Ihre Claude-Organisation.“ Verwenden Sie unsere Branding-Beispiele.

  6. Erstellen Sie ein Benutzerprofil für jede Kundenorganisation, die zahlen wird. Jede App ermöglicht ein Profil pro Kundenorganisation und eine Kundenorganisation pro Profil.

  7. Senden Sie bei jeder Anfrage, die der Kunde zahlen soll, die Profil-ID des Kunden, den Billing-Beta-Header und billing_policy mit bill_to auf user_profile ein.

  8. Veröffentlichen Sie die App, wenn Sie bereit für Kunden sind.

Eine neue App startet im Testmodus. Nur die Testbenutzer, die Sie auflisten (bis zu 10), können sie verknüpfen, jeweils mit einem monatlichen Limit von 50 USD oder weniger. Sofern Ihre Organisation keine Rechnungsabrechnung hat, Sie Ihre App-Domäne überprüfen und Anthropic die App überprüft, bevor sie live geht.

Verknüpfungsregeln

  • Wenn die Organisation eines Kunden bereits über ein anderes Profil mit Ihrer App verknüpft ist, wird die Verknüpfung abgelehnt.

  • Ein Profil, das bereits mit Ihrer App verknüpft ist, kann nicht mit einer zweiten Organisation verknüpft werden.

  • Um eine Verknüpfung zu verschieben, heben Sie die Verknüpfung zuerst auf und verknüpfen Sie dann erneut.

  • Sie können Ihre App nicht mit der Claude Console-Organisation verknüpfen, die sie besitzt. Um verknüpfte Abrechnung wie ein Kunde zu testen, verwenden Sie eine zweite Claude Console-Organisation, die verknüpft werden kann.

  • Verwenden Sie dieselbe Benutzerprofile-ID, um die Verknüpfung zu starten und die Anfragen dieses Kunden zu stellen.

  • Eine kundengebührenpflichtige Anfrage, die ein Profil ohne Verknüpfung benennt, wird mit einem 403-Fehler abgelehnt, auch wenn die Console des Kunden Ihre Plattform als „Verknüpft“ anzeigt.

  • Eine kundengebührenpflichtige Anfrage, die ein anderes Profil Ihrer Kunden benennt, wird diesem Kunden in Rechnung gestellt.

Um für Ihre eigene Nutzung zu zahlen, senden Sie Anfragen ohne billing_policy.

Für die vollständigen Schritte und Header-Werte siehe die Claude Platform Docs.

Was Kunden sehen, wenn sie verknüpfen

Wenn Kunden ihre Organisation verknüpfen:

  1. Sie klicken auf die Schaltfläche, die Sie Ihrer App hinzugefügt haben, z. B. „Verknüpfen Sie Ihre Claude-Organisation.“

  2. Sie melden sich bei Claude an. Wenn ihre E-Mail zu mehr als einer Organisation gehört, wählen sie eine aus. Wenn sie noch kein Claude-Konto oder keine Claude Console-Organisation haben, können sie diese hier erstellen, Guthaben hinzufügen und dann zurückkehren, um die Verknüpfung abzuschließen.

  3. Sie lesen, wie die Abrechnung funktioniert, und legen dann ein monatliches Ausgabenlimit für Ihre App fest oder fahren ohne eines fort. Wenn sich Ihre App noch im Testmodus befindet, müssen sie ein Limit von 50 USD oder weniger festlegen.

  4. Sie sehen eine Genehmigungsseite mit dem Namen Ihrer App und dem, was Sie anfordern. Es heißt, dass die Nutzung unter den bestehenden Abrechnungsbedingungen der Organisation abgerechnet wird.

  5. Sie genehmigen und kehren zu Ihrer App zurück.

Nur ein Benutzer mit der Rolle Admin oder Billing kann genehmigen. Erfahren Sie mehr über Claude Console-Rollen und -Berechtigungen. Wenn jemand anderes versucht zu genehmigen, senden wir ihn mit einem Zugriff verweigert-Fehler zu Ihrer App zurück. Planen Sie eine Übergabe, z. B. eine Möglichkeit, die Anfrage an einen Administrator weiterzuleiten.

Eine Genehmigung gilt für die gesamte Organisation. Die Verknüpfung gehört der Organisation, daher bleibt sie aktiv, wenn der Genehmiger geht. Jede Organisation kann eine Verknüpfung pro App haben.

Nach der Genehmigung erhalten die Admin- und Billing-Mitglieder des Kunden normalerweise eine E-Mail, die die Verknüpfung bestätigt, und eine weitere, wenn sie die Verknüpfung aufheben.

Wie Kunden eine Verknüpfung verwalten

Kunden verwalten jede Verknüpfung auf der Seite Verknüpfte Plattformen in der Claude Console. Sie können ein monatliches Ausgabenlimit für Ihre Plattform festlegen und die Verknüpfung jederzeit aufheben. Verlinken Sie diese Seite von Ihrer App aus.

Sie können einen Kunden auch aufheben. Ein Admin in Ihrer Organisation tut dies auf der Seite Benutzerprofile. Der Kunde erhält keine E-Mail, wenn Sie die Verknüpfung in der Console aufheben, daher teilen Sie es ihm selbst mit. Sie können einen Kunden auch von Ihrem Backend aus aufheben, und Anthropic sendet ihm normalerweise eine E-Mail, wenn Sie dies tun.

Sie können auch Kundenprofile mit der User Profiles API erstellen, auflisten und aktualisieren.

Verwalten Sie nicht verknüpfte Kunden

Anthropic sendet Ihrer App keine Benachrichtigung, wenn ein Kunde die Verknüpfung aufhebt. Sie erfahren es, wenn eine kundengebührenpflichtige Anfrage für diesen Kunden mit einem 403-Fehler abgelehnt wird, oder vom „Link-Status“ auf Ihrer Seite „Benutzerprofile“ in der Console. Ein 403 kann auch bedeuten, dass der Kunde aus einem anderen Grund nicht abgerechnet werden kann.

Ein Status „Verknüpft“ besagt nur, dass die Verknüpfung vorhanden ist. Eine Anfrage kann immer noch abgelehnt werden, z. B. wenn dem Kunden das Guthaben ausgeht oder ein Ausgabenlimit erreicht hat.

Das Aufheben der Verknüpfung stoppt normalerweise neue Aufrufe innerhalb von etwa 10 Sekunden. Bereits laufende Aufrufe werden abgeschlossen und dem Kunden in Rechnung gestellt. Zeigen Sie dem Kunden eine klare Nachricht und eine Möglichkeit an, die Verknüpfung erneut herzustellen.

Verwalten Sie Abrechnungsfehler

Wenn ein Kunde nicht abgerechnet werden kann, lehnen wir die Anfrage ab. Wir berechnen Ihnen diese Anfrage nicht.

  • Wenn der Kunde sein Ausgabenlimit erreicht hat oder Anthropic ihn derzeit nicht abrechnen kann (z. B. weil ihm das Guthaben ausgeht oder er gesperrt ist), erhalten Sie einen 402-Fehler.

  • Wenn Anthropic den Kunden aus einem anderen Grund nicht abrechnen kann, erhalten Sie einen 403-Fehler.

  • Wenn Anthropic derzeit nicht bestätigen kann, ob der Kunde abgerechnet werden kann, erhalten Sie möglicherweise einen 503-Fehler. Versuchen Sie es mit Backoff erneut und zeigen Sie dem Kunden keinen Fehler an.

Ein 402 bedeutet, dass der Kunde handeln muss. Bitten Sie ihn, seine Limits und Abrechnung in der Claude Console zu überprüfen.

Sie entscheiden, was als Nächstes passiert. Sie können die Funktion anhalten, bis der Kunde handelt, oder Sie können die Nutzung selbst abdecken, indem Sie die Anfrage als plattformgebührenpflichtig erneut senden. Wenn Sie es abdecken, teilen Sie dem Kunden mit, wie lange.

Überwachen Sie Nutzung und Ausgaben

Sie sehen die Nutzung jedes Kunden und was sie Sie kostet. Sie sehen nie, was der Kunde tatsächlich zahlt.

Sie können die Nutzung jedes Kunden auf zwei Arten überwachen:

  • In der Claude Console: Wählen Sie einen Kunden auf der Seite Benutzerprofile aus, um seine Nutzung anzuzeigen. Ihre Ausgaben sind nur das, was Sie im Namen des Kunden bezahlt haben.

  • Mit der API: Gruppieren Sie Ergebnisse nach user_profile_id in der Usage and Cost Analytics API, die sich in der Beta-Phase befindet. Der Nutzungsendpunkt gibt Token zurück. Auf dem Kostenendpunkt ist amount Ihre Kosten vor Guthaben, und es ist 0 für Anfragen, die Ihr Kunde zahlt. list_amount sind die Kosten zum Listenpreis, unabhängig davon, wer zahlt.

Beide Ansichten enthalten jede Anfrage für den Kunden, unabhängig davon, wer zahlt. Führen Sie Ihre eigene Aufzeichnung darüber, welche Anfragen kundengebührenpflichtig waren. API-Daten werden normalerweise innerhalb von vier Stunden aktualisiert und können bis zu 24 Stunden dauern.

Häufig gestellte Fragen

Können Kunden mit HIPAA-, FERPA- oder CMEK-Anforderungen verknüpfen?

Nicht während der Beta. Verknüpfte Anfragen werden in Ihrer Organisation ausgeführt, daher gelten die Business Associate Agreement (BAA), Verschlüsselungsschlüssel und Aufbewahrungseinstellungen eines Kunden, einschließlich Null-Datenspeicherung, nicht. Verknüpfen Sie keine Kunden, die HIPAA-, FERPA- oder CMEK-Abdeckung benötigen.

Welche Guthaben können für verknüpfte Nutzung zahlen?

Verknüpfte Nutzung wird dem Prepaid-Guthaben oder der Rechnung des Kunden in Rechnung gestellt. Einige Aktionsguthaben können nicht verwendet werden.

Was kann zahlen

  • Guthaben, das der Kunde gekauft hat (sein Prepaid-Guthaben)

  • Die Rechnung des Kunden, falls monatlich abgerechnet

  • Abrechnungskorrektionen von Anthropic

  • Guthaben, das in die Vereinbarung des Kunden geschrieben wurde

Was kann nicht zahlen

Wenn nichts auf dem Konto des Kunden zahlen kann, können seine Anfragen abgelehnt werden. Nachdem der Kunde Guthaben hinzugefügt hat, kann der Kauf einige Zeit dauern, bis er angewendet wird. Wir können diese Liste aktualisieren, wenn sich unsere Guthabenprogramme ändern.

Hat dies deine Frage beantwortet?