Zum Hauptinhalt springen
Die DeepMask API hat eine eigene Abrechnung nach Verbrauch, getrennt von Ihrem Chat-Tarif. Sie zahlen die Modellkosten der Anfragen, die über Ihre Schlüssel gestellt werden, plus eine Gebühr von 3 %. Gegebenenfalls kommt Umsatzsteuer hinzu. Eine feste monatliche Gebühr gibt es nicht. Auf der Registerkarte Abrechnung der Einstellungsseite API aktivieren Sie die Abrechnung, prüfen Ihre Rechnungen und beenden die Abrechnung bei Bedarf.
Registerkarte „Abrechnung“: Die Karte „API-Abrechnung“ zeigt „Nach Verbrauch“ mit dem Status „Aktiv“ und den Hinweis „Ihre monatliche Rechnung enthält die Modellkosten plus 3 % Gebühr, zzgl. USt., falls zutreffend.“ Daneben steht das Gateway-Ausgabenlimit von 250 € mit der Schaltfläche „Limit speichern“. Darunter stehen zwei bezahlte Rechnungen mit den Links „Rechnung ansehen“. Ganz unten folgt der Bereich „API-Abrechnung beenden“.

Die Registerkarte „Abrechnung“ zeigt den Status Ihrer API-Abrechnung, was Ihre Rechnung enthält, das Gateway-Ausgabenlimit, Ihre API-Rechnungen und den Bereich zum Beenden der Abrechnung.

Voraussetzungen

  • Sie müssen Administrator der Organisation sein. Nur Administratoren sehen API in der Seitenleiste der Einstellungen.
  • Ihre Organisation braucht einen aktiven kostenpflichtigen Chat-Tarif: Pro, Power oder Enterprise. Der kostenlose Tarif und Testphasen erfüllen diese Voraussetzung nicht. Das gilt auch für einen Chat-Tarif mit überfälliger Zahlung.
  • Schlüssel setzen eine aktive API-Abrechnung voraus. Sie können Schlüssel erst erstellen, wenn die API-Abrechnung den Status Aktiv hat. Siehe API-Schlüssel.

API-Abrechnung aktivieren

1

Registerkarte „Abrechnung“ öffnen

Klicken Sie unten in der Chat-Seitenleiste auf Ihren Namen, wählen Sie Benutzereinstellungen, klicken Sie in der Seitenleiste der Einstellungen auf API und wählen Sie die Registerkarte Abrechnung. Die Karte API-Abrechnung zeigt den Status Nicht aktiviert.
2

Checkout starten

Klicken Sie auf API-Abrechnung aktivieren. Sie finden die Schaltfläche auch im Hinweis, der auf den anderen Registerkarten erscheint. DeepMask leitet Sie zu Stripe Checkout weiter.
3

Zahlungs- und Rechnungsdaten angeben

Der Checkout fragt nach einer Zahlungsmethode und einer Rechnungsadresse. Sind für Ihre Organisation bereits ein Name und eine Rechnungsadresse hinterlegt, füllt der Checkout diese aus. Optional können Sie auch eine Umsatzsteuer-Identifikationsnummer (USt-IdNr.) angeben.
  • Der Checkout verwendet dasselbe Abrechnungskonto wie Ihr Chat-Tarif. Wenn Sie hier einen Namen, eine Adresse oder eine USt-IdNr. ändern oder hinzufügen, gilt das auch für die Abrechnung Ihres Chat-Tarifs.
  • Der Checkout legt ein separates API-Abonnement an.
  • Beim Checkout wird Ihnen nichts berechnet. Ihre Nutzung wird erstmals nach Ende des laufenden Monats berechnet.
4

Zu DeepMask zurückkehren

Nach dem Checkout gelangen Sie zurück zur Registerkarte Schlüssel der Seite API, die sich automatisch aktualisiert. Wählen Sie die Registerkarte Abrechnung und prüfen Sie, ob die Karte API-Abrechnung den Status Aktiv zeigt. Ist das noch nicht der Fall, klicken Sie oben auf der Seite auf Aktualisieren.
Wenn Sie den Checkout verlassen, ohne ihn abzuschließen, bleibt die API-Abrechnung Nicht aktiviert. Klicken Sie erneut auf API-Abrechnung aktivieren, sobald Sie bereit sind.
Das Aktivieren der API-Abrechnung ändert weder Ihren Chat-Tarif noch dessen Preis. API-Nutzung erscheint nie auf Ihren Chat-Rechnungen.
Das Gateway-Ausgabenlimit Ihrer Organisation liegt anfangs bei 100 €. Das ist das organisationsweite monatliche Limit, das für alle Schlüssel gemeinsam gilt. Sie können es auf der Registerkarte Abrechnung bis zu dem Höchstwert ändern, der unter dem Feld angezeigt wird (standardmäßig 500 €). Unter Ausgabenlimits erfahren Sie, wie Limits funktionieren und wie Sie den Höchstwert anheben.

Was Sie bezahlen

Ihre monatliche API-Rechnung weist eine einzige Nutzungsposition aus: die Modellkosten Ihrer Anfragen plus eine Gebühr von 3 %. Die Gebühr erscheint nicht als eigene Position. Gegebenenfalls kommt Umsatzsteuer hinzu, abhängig von der Rechnungsadresse und der USt-IdNr. in Ihrem Abrechnungskonto. Die Karte API-Abrechnung auf der Registerkarte Abrechnung fasst das so zusammen: „Ihre monatliche Rechnung enthält die Modellkosten plus 3 % Gebühr, zzgl. USt., falls zutreffend.“ Andere Bereiche der Seite API, etwa die Registerkarte Nutzung und die Felder für Ausgabenlimits, sprechen stattdessen von Steuern. Um Ihre Rechnungsadresse oder USt-IdNr. nach dem Checkout zu ändern, wenden Sie sich an den Support. Die Nutzungsposition berechnet sich so: Zum Beispiel werden 50 € Modellkosten vor Umsatzsteuer mit 51,50 € abgerechnet. Die Registerkarte Modelle zeigt für jedes Modell die Eingabe- und Ausgabepreise pro 1 Mio. Tokens, in denen die Gebühr von 3 % bereits enthalten ist. Berechnen Sie mit diesen Preisen die Kosten für die Tokens einer Anfrage. So erhalten Sie den Betrag, der Ihnen dafür vor Umsatzsteuer in Rechnung gestellt wird. Rechnen Sie die Gebühr nicht noch einmal hinzu. Die Preise werden automatisch aktualisiert. Prüfen Sie die aktuellen Preise daher auf der Registerkarte Modelle, statt eine Kopie zu speichern. Die Preise auf der Registerkarte Modelle und die Summe Monatliche API-Kosten auf der Registerkarte Nutzung werden vor Umsatzsteuer angezeigt. Die Beträge in der Liste Rechnungen sind Rechnungssummen einschließlich gegebenenfalls anfallender Umsatzsteuer. Bei manchen Modellen gilt für sehr lange Prompts ein höherer Preis. Bei einigen wird außerdem zwischengespeicherte Eingabe zu einem niedrigeren Preis abgerechnet. Unter Modelle erfahren Sie, wie diese Preise funktionieren. Bilder, die Sie senden, zählen als Eingabe-Tokens. Sie werden zu denselben Eingabepreisen wie Text abgerechnet. Siehe Wie Bilder abgerechnet werden.

Was berechnet wird und was nicht

Berechnet:
  • Abgeschlossene Anfragen, abgerechnet nach den Eingabe- und Ausgabe-Tokens, die sie verbrauchen.
  • Anfragen, bei denen Ihre Anwendung die Verbindung trennt oder in ein Timeout läuft, nachdem DeepMask die Anfrage an das Modell gesendet hat. Die Anfrage wird bei DeepMask trotzdem abgeschlossen und wie jede andere abgerechnet.
  • Nutzung, die der Anbieter für eine Anfrage mit unklarem Ergebnis nachträglich noch meldet. Sie wird wie jede andere Nutzung abgerechnet.
Nicht berechnet:
  • Anfragen, die DeepMask ablehnt, bevor sie ein Modell erreichen. Beispiele sind ein ungültiger oder widerrufener Schlüssel, ein Modell, das der Schlüssel nicht nutzen darf, eine ungültige Anfrage oder ein ungültiges Bild, ein Ratenlimit oder ein erreichtes Ausgabenlimit.
  • Anfragen, bei denen Ihre Anwendung die Verbindung trennt, bevor DeepMask die Anfrage an das Modell sendet.
  • Anfragen, die der Modellanbieter als ungültig ablehnt, bevor eine Ausgabe entsteht, etwa ein Prompt, der länger als das Kontextfenster des Modells ist, oder ein Bild, das der Anbieter nicht verarbeiten kann.
  • Anfragen mit unklarem Ergebnis, bei denen DeepMask nicht feststellen kann, ob die Anfrage abgeschlossen wurde. Beispiele sind ein Serverfehler oder Timeout beim Modellanbieter, ein Stream, der mittendrin abbricht, und eine Anfrage, die das Limit von 15 Minuten erreicht. Für sich allein pausiert ein unklares Ergebnis die Anfragen Ihrer Organisation nicht.
Bis zu 20 unklare Ergebnisse Ihrer Organisation innerhalb von 24 Stunden werden kostenlos freigegeben. Das ist das 24-Stunden-Kontingent Ihrer Organisation. Darüber hinaus prüft DeepMask jedes weitere unklare Ergebnis. Bis DeepMask diese Ergebnisse geklärt hat, sind die API-Anfragen Ihrer Organisation pausiert. Siehe Unklare Ergebnisse. Die vollständige Liste der Fehlercodes finden Sie unter Fehler und Wiederholungen.

Wann Sie eine Rechnung erhalten

Ihr API-Abrechnungszeitraum entspricht dem Kalendermonat (UTC). Der erste Zeitraum läuft vom Tag, an dem Sie die Abrechnung aktivieren, bis zum Ende dieses Monats. Danach umfasst jeder Zeitraum einen vollen Monat. Kurz nach Ende jedes Zeitraums stellt DeepMask die Rechnung für diesen Zeitraum aus. Sie umfasst die Modellkosten und die Gebühr von 3 % aus diesem Zeitraum sowie gegebenenfalls Umsatzsteuer. Der Betrag wird automatisch von der Zahlungsmethode abgebucht, die Sie im Checkout hinterlegt haben. Schlägt diese Zahlung fehl, lesen Sie Wenn eine Zahlung fehlschlägt. Die Summe des laufenden Monats sehen Sie schon vor der Rechnung auf der Karte Monatliche API-Kosten auf der Registerkarte Nutzung. Sie enthält die Gebühr von 3 %, aber keine Umsatzsteuer. Siehe Nutzung und Protokolle.
Anfragen aus den letzten Minuten eines Monats werden unter Umständen erst erfasst, nachdem der Abrechnungszeitraum abgeschlossen ist. Diese Anfragen erscheinen auf der nächsten Rechnung. Die Registerkarte Nutzung ordnet sie trotzdem dem Monat zu, in dem sie begonnen haben. Daher kann die Nutzungssumme eines Monats leicht von der Rechnung für diesen Monat abweichen. Wenn die API-Abrechnung mit diesem Zeitraum geendet hat, lesen Sie API-Abrechnung beenden.

Rechnungen

Die Liste Rechnungen auf der Registerkarte Abrechnung zeigt nur Ihre API-Rechnungen. Rechnungen für Ihren Chat-Tarif finden Sie weiterhin unter Abrechnung in der Seitenleiste der Einstellungen. Jede Zeile zeigt das Rechnungsdatum, den Status und den Betrag. Mögliche Statuswerte sind Bezahlt, Offen, Uneinbringlich, Storniert und Entwurf. Eine neue Rechnung hat nach Ende des Zeitraums etwa eine Stunde lang den Status Entwurf, bis sie finalisiert ist.
  • Klicken Sie auf Rechnung bezahlen, um eine offene Rechnung zu begleichen, auf der noch ein Betrag fällig ist.
  • Klicken Sie auf Rechnung ansehen, um jede andere finalisierte Rechnung anzuzeigen. Rechnungsentwürfe haben erst nach der Finalisierung einen Link.
  • Eine als Uneinbringlich markierte Rechnung mit noch fälligem Betrag müssen Sie bezahlen, bevor der API-Zugriff wiederhergestellt wird. Klicken Sie auf Rechnung ansehen und bezahlen Sie sie auf der Rechnungsseite. Falls das dort nicht möglich ist, wenden Sie sich an den Support.
Beide Links öffnen die Rechnungsseite in einem neuen Browser-Tab. Die Liste zeigt jeweils 10 Rechnungen. Klicken Sie auf Weitere laden, um ältere Rechnungen zu sehen.

Status der API-Abrechnung

Die Karte API-Abrechnung zeigt den Status Ihres API-Abonnements. Ihre Schlüssel können Anfragen nur verarbeiten, solange der Status Aktiv ist.

Wenn eine Zahlung fehlschlägt

Schlägt die Zahlung einer API-Rechnung fehl, pausiert DeepMask den API-Zugriff, bis die Rechnung bezahlt ist. Sie sehen dann Folgendes:
  • Den Hinweis „Die Zahlung einer API-Rechnung ist fehlgeschlagen. Begleichen Sie die offenen API-Rechnungen, um den Zugriff wiederherzustellen.“ mit der Schaltfläche Rechnungen anzeigen.
  • Schlüssel haben den Status Inaktiv. Sie werden nicht widerrufen.
  • Sie können keine neuen Schlüssel erstellen.
  • API-Anfragen werden abgelehnt. Eine fehlgeschlagene Zahlung versetzt das API-Abonnement meist in den Status Überfällig oder Unbezahlt. Anfragen werden dann mit API_SUBSCRIPTION_INACTIVE (HTTP 403) abgelehnt. Solange das Abonnement noch den Status Aktiv hat, lautet der Fehler API_PAYMENT_FAILED (HTTP 402).
So stellen Sie den Zugriff wieder her:
1

Rechnungen öffnen

Klicken Sie im Hinweis auf Rechnungen anzeigen oder wählen Sie die Registerkarte Abrechnung.
2

Jede offene Rechnung bezahlen

Klicken Sie neben jeder offenen Rechnung auf Rechnung bezahlen und schließen Sie die Zahlung auf der Rechnungsseite ab. Bei einer als Uneinbringlich markierten Rechnung klicken Sie auf Rechnung ansehen und bezahlen sie dort.
3

Prüfen, ob der Zugriff wiederhergestellt ist

DeepMask prüft Ihre Abrechnung etwa einmal pro Minute und stellt den Zugriff selbstständig wieder her. Um früher zu prüfen, klicken Sie auf Aktualisieren. Sobald der Zugriff wiederhergestellt ist, haben Ihre Schlüssel wieder den Status Aktiv. Zeigt die Karte API-Abrechnung nach der Zahlung den Status Gekündigt, klicken Sie auf API-Abrechnung aktivieren, um ein neues Abonnement zu starten. Ihre bestehenden Schlüssel funktionieren wieder, sobald die Abrechnung Aktiv ist.
Solange unbezahlte API-Rechnungen offen sind, können Sie kein neues API-Abonnement starten. Bezahlen Sie diese zuerst.

API-Abrechnung beenden

1

Option zum Beenden finden

Scrollen Sie auf der Registerkarte Abrechnung zu API-Abrechnung beenden und klicken Sie auf Abrechnung beenden. Dieser Bereich erscheint nur, solange die API-Abrechnung Aktiv ist und keine Kündigung vorgemerkt ist.
2

Bestätigen

Klicken Sie im Dialog API-Abrechnung beenden? auf API-Abrechnung beenden.
Die Kündigung wird zum Ende des laufenden Abrechnungszeitraums wirksam, also zum Ende des Kalendermonats in UTC:
  • Ihre Schlüssel funktionieren bis zum Ende des Zeitraums weiter, und Sie bezahlen bis dahin für ihre Nutzung.
  • Die Karte API-Abrechnung zeigt „Die API-Abrechnung endet zum Ende dieses Abrechnungszeitraums.“ mit der Schaltfläche API-Abrechnung behalten. Derselbe Hinweis erscheint auf den anderen Registerkarten.
  • Wenn der Zeitraum endet, wechselt der Status zu Gekündigt, und Ihre Schlüssel werden als Inaktiv angezeigt. Anfragen werden mit API_SUBSCRIPTION_INACTIVE abgelehnt.
  • Nach Ende des Zeitraums erhalten Sie eine Schlussrechnung für die Nutzung in diesem Zeitraum.
  • Ihre Schlüssel werden nicht widerrufen. Wenn Sie die API-Abrechnung später wieder aktivieren, funktionieren sie wieder.
  • Ihr Chat-Tarif ist nicht betroffen.
Nutzung, die nach dem Ende der Abrechnung erfasst wird, kann auf keiner späteren Rechnung erscheinen. Deshalb prüft DeepMask sie zuerst. Das kann bei Anfragen vorkommen, die in den letzten Minuten vor dem Ende der Abrechnung liefen. Es kann auch vorkommen, wenn die Nutzung für eine Anfrage mit unklarem Ergebnis verspätet eintrifft. Bis die Prüfung abgeschlossen ist, zeigt die Seite möglicherweise den Hinweis „API-Anfragen sind pausiert, während die letzte Nutzung geprüft wird. Wenden Sie sich an DeepMask, falls das anhält.“ Das gilt auch, wenn Sie die API-Abrechnung in der Zwischenzeit wieder aktivieren. Bleibt der Hinweis länger als ein paar Minuten bestehen, wenden Sie sich an den Support.

API-Abrechnung behalten

Haben Sie es sich anders überlegt? Klicken Sie vor Ende des Zeitraums auf API-Abrechnung behalten. Sie sehen dann die Bestätigung „Die API-Abrechnung läuft weiter.“ Sonst ändert sich nichts. Nach Ende des Zeitraums ist API-Abrechnung behalten nicht mehr verfügbar. Klicken Sie auf API-Abrechnung aktivieren, um den Checkout erneut zu durchlaufen.

Wenn sich Ihr Chat-Tarif ändert

Der API-Zugriff hängt von Ihrem Chat-Tarif ab. Er wird sofort pausiert, wenn der Chat-Tarif Ihrer Organisation endet und die Organisation zum kostenlosen Tarif wechselt oder wenn eine Chat-Zahlung fehlschlägt. Wenn Sie Ihren Chat-Tarif kündigen, bleibt der API-Zugriff bis zum Ende des Chat-Tarifs bestehen. Solange der API-Zugriff pausiert ist:
  • Der Hinweis „Für den API-Zugriff ist ein aktiver kostenpflichtiger Chat-Tarif erforderlich.“ erscheint mit dem Link Chat-Abrechnung.
  • Schlüssel haben den Status Inaktiv, und Sie können keine neuen erstellen.
  • API-Anfragen werden mit API_SUBSCRIPTION_INACTIVE (HTTP 403) abgelehnt.
  • Ist die API-Abrechnung noch nicht eingerichtet, ist die Schaltfläche API-Abrechnung aktivieren deaktiviert.
Die API-Abrechnung hat keine feste Gebühr. Solange der API-Zugriff pausiert ist, wird Ihnen also nichts berechnet. Ihr API-Abonnement wird nicht automatisch gekündigt, und Ihre Schlüssel werden nicht widerrufen. Sobald Ihre Organisation wieder einen aktiven kostenpflichtigen Tarif hat, wird der API-Zugriff automatisch wiederhergestellt. Wenn Sie die API nicht mehr nutzen möchten, beenden Sie die API-Abrechnung auf der Registerkarte Abrechnung.

Kontohinweise

Oben auf der API-Seite erscheint höchstens ein Kontohinweis, und zwar der dringendste. Die Tabelle führt die Hinweise nach absteigender Dringlichkeit auf. Die letzten beiden Hinweise erscheinen nicht auf der Registerkarte Abrechnung, weil die Karte API-Abrechnung dort dieselben Informationen zeigt. Wenn ein Teil der Seite nicht geladen werden kann, erscheint über dem Kontohinweis ein Fehlerhinweis mit Erneut versuchen.

Häufige Fragen

Nein. Die API-Abrechnung ist ein separates Abonnement nach Verbrauch mit eigenen Rechnungen. Ihr Chat-Tarif und dessen Preis bleiben unverändert, und API-Nutzung erscheint nie auf Ihren Chat-Rechnungen.
Nein. Sie zahlen nur die Modellkosten Ihrer Anfragen plus die Gebühr von 3 % und gegebenenfalls Umsatzsteuer.
Ja, sofern Umsatzsteuer anfällt. Die Umsatzsteuer kommt zur Nutzungsposition hinzu, abhängig von der Rechnungsadresse und der USt-IdNr. in Ihrem Abrechnungskonto. Die Preise auf der Registerkarte Modelle und die Summe Monatliche API-Kosten auf der Registerkarte Nutzung verstehen sich vor Umsatzsteuer. Siehe Was Sie bezahlen.
Nein. Sie zahlen nur für die Nutzung. Die erste Abbuchung erfolgt mit der Rechnung nach Ende des laufenden Monats.
Es begrenzt die Modellkosten, also den Betrag vor der Gebühr von 3 % und vor Umsatzsteuer. Ein Limit von 100 € erlaubt etwa 100 € Modellkosten. Das entspricht vor Umsatzsteuer etwa 103 € auf Ihrer Rechnung. Bereits laufende Anfragen können dazu führen, dass die Ausgaben das Limit leicht überschreiten. Betrachten Sie es daher als ungefähre Grenze, nicht als exakten Höchstbetrag Ihrer Rechnung. Siehe Ausgabenlimits.
Die Summe auf der Registerkarte Nutzung enthält keine Umsatzsteuer, die Ihre Rechnung gegebenenfalls hinzufügt. Außerdem erscheinen Anfragen aus den letzten Minuten eines Monats unter Umständen erst auf der nächsten Rechnung. Solange einige Anfragen noch geprüft werden, weist die Registerkarte Nutzung darauf hin, dass sich die Summe dieses Monats noch ändern kann. Siehe Wann Sie eine Rechnung erhalten.
Nein. Für den API-Zugriff ist ein aktiver kostenpflichtiger Pro-, Power- oder Enterprise-Tarif erforderlich. Testphasen reichen nicht aus.
Sie funktionieren bis zum Ende des Abrechnungszeitraums weiter. Danach haben sie den Status Inaktiv, bleiben aber auf der Registerkarte Schlüssel erhalten. Wenn Sie die API-Abrechnung wieder aktivieren, funktionieren sie wieder. Wird die Nutzung aus den letzten Minuten vor dem Ende der Abrechnung noch geprüft, funktionieren sie wieder, sobald die Prüfung abgeschlossen ist. Um einen Schlüssel dauerhaft zu sperren, widerrufen Sie ihn. Siehe API-Schlüssel.

Fehlerbehebung

Die Schaltfläche „API-Abrechnung aktivieren“ ist deaktiviert? Ihre Organisation hat keinen aktiven kostenpflichtigen Chat-Tarif, oder das API-Konto ist geschlossen. Der Hinweis oben auf der Seite zeigt, was davon zutrifft. Nach dem Klick auf „API-Abrechnung aktivieren“ erscheint ein Fehler? Der Fehlerhinweis erklärt, was fehlt. Diese Meldungen zeigt die App auf Englisch an: Nach dem Checkout steht der Status weiterhin auf „Nicht aktiviert“? Klicken Sie auf Aktualisieren, um Ihren Abrechnungsstatus zu synchronisieren. Schlüssel haben den Status „Inaktiv“, aber kein Hinweis erklärt den Grund? Prüfen Sie den Status auf der Karte API-Abrechnung. Lautet er Überfällig, Unbezahlt oder Unvollständig, bezahlen Sie alle offenen Rechnungen in der Liste Rechnungen und klicken Sie dann auf Aktualisieren.

Verwandte Seiten

Ausgabenlimits

Legen Sie das organisationsweite Limit und optionale Limits für einzelne Schlüssel fest.

Nutzung und Protokolle

Verfolgen Sie monatliche Kosten, Limits und jede einzelne Anfrage.

Modelle

Sehen Sie sich verfügbare Modelle und ihre Preise an.

Fehler und Wiederholungen

Schlagen Sie Fehlercodes nach und erfahren Sie, ob fehlgeschlagene Anfragen abgerechnet werden.