Detaillierte API‑Nutzungsberichte mit dem neuen DeepL API-Parameter für abgerechnete Zeichen

Zusammenfassung

• Nutzer der DeepL API können jetzt die Anzahl der abgerechneten Zeichen für jede erfolgreiche API‑Anfrage abrufen.
• Der Parameter show_billed_characters (Abgerechnete Zeichen anzeigen) bietet ihnen Zugang zu API‑Nutzungsdaten direkt in der API‑Antwort.
• Diese Nutzungsdaten pro Anfrage können direkt über die API in individuellen Reporting‑ und Kostentracking-Workflows verwendet werden.
• Das ist besonders nützlich für strukturierte Inhalte wie HTML oder XML, bei denen sich die zu übersetzenden Zeichen oft nur schwer ermitteln lassen.
• Die Funktion erweitert die DeepL API-Berichte über den Endpunkt /usage hinaus und hilft Ihnen, Übersetzungsaktivitäten präziser zu überwachen.
• Der neue Parameter show_billed_characters steht allen DeepL API-Kunden sofort und ohne zusätzliche Einrichtung zur Verfügung.

Bei der DeepL API haben Reporting und Analytics für Entwickler und Unternehmen wie Ihres schon immer Priorität – egal, ob über den Endpunkt /usage direkt in der API selbst oder über die Reporting-Funktion für mehrere API‑Schlüssel.

Und jetzt hat unser Team die Reporting-Tools um eine praktische neue Option ergänzt: show_billed_characters steht nun allen API‑Kunden zur Verfügung.

Damit bieten die Reporting-Funktionen der DeepL API jetzt eine detaillierte Übersicht darüber, wie viele Zeichen in den Antwortdaten jeder API‑Anfrage abgerechnet werden.

Entdecken Sie, wie die DeepL API Ihnen dabei hilft, mit unserer leistungsstarken KI‑Sprachtechnologie noch mehr zu erreichen.

Was ist der Parameter show_billed_characters?

Bisher hatten API‑Nutzer, die genaue Nutzungsdaten direkt über die DeepL API abrufen wollten, nur eine einzige Möglichkeit: den Endpunkt /usage. Das ist zwar eine leistungsstarke Methode, um die neuesten Daten zum Zeichenverbrauch für den aktuellen Abrechnungszeitraum abzurufen, doch sie liefert keine genaue Aufschlüsselung der Zeichen, die bei jeder Anfrage übersetzt werden.

Ein optionaler Parameter löst dieses Problem, indem er die Anzahl der übersetzten und abgerechneten Zeichen zusammen mit der Antwort jeder erfolgreichen API‑Anfrage zurückgibt.

Entdecken Sie flexible Berichte auf Schlüsselebene für DeepL API-Nutzer.

Wie funktioniert der Parameter show_billed_characters?

API‑Kunden, die Anfragen direkt an die API senden, beispielsweise über einen cURL‑Befehl, können den neuen Parameter show_billed_characters zu ihren Anfragen hinzufügen. Hierdurch wird die Anzahl der abgerechneten Zeichen als Teil der Antwortdaten zurückgegeben. 

API‑Antworten, bei denen Zeichenkosten anfallen, geben dann bei jeder Antwort einen neuen ganzzahligen Wert im Format „billed_characters:50“ zurück.

Sie können diesen Wert auf API‑Nutzerseite verfolgen, um ihn in Reporting-Workflows zu verwenden und die Kosten jeder einzelnen API‑Anfrage nachzuverfolgen.

Das ist besonders wichtig für Anfragen mit strukturierten Inhalten wie HTML oder XML, bei denen sich die zu übersetzenden Zeichen oft nur schwer ermitteln lassen.

Das DeepL-Team beabsichtigt, billed_characters künftig standardmäßig in die API‑Antwort aufzunehmen. Dann wird es erforderlich sein, show_billed_characters auf false zu setzen, wenn billed_characters nicht in die API‑Antwort aufgenommen werden soll.

Erfahren Sie, wie DeepL die Sicherheit durch mehrere API‑Schlüssel erhöht.

So sieht die API‑Antwort mit show_billed_characters aus

Wenn Sie eine Anfrage an die API senden, erhalten Sie derzeit eine Antwort wie die folgende:

Wenn Sie eine Anfrage mit dem neuen Parameter show_billed_characters senden, sieht Ihre Antwort wie folgt aus:

Lernen Sie die sechs Übersetzungstrends kennen, die sich globale Unternehmen jetzt zunutze machen sollten.

Warum DeepL abgerechnete Zeichen pro Anfrage eingeführt hat

Zahlreiche Kunden haben diese Möglichkeit angefordert. Hiermit können Sie die Zeichenabrechnung detailliert auswerten und diese Daten bei jeder erfolgreichen API‑Übersetzungsanfrage direkt in Ihre eigenen Reporting-Tools integrieren.

DeepL-Nutzer können den Parameter show_billed_characters sofort innerhalb der DeepL API verwenden – ganz ohne zusätzliche Einrichtung. 

Darüber hinaus haben wir unsere API‑Dokumentation aktualisiert, um diese Änderung widerzuspiegeln. So können Entwickler wie Sie diese Funktion problemlos in ihre Workflows integrieren und von einer höheren Übersetzungsgenauigkeit profitieren.

Weitere Informationen finden Sie in den Beschreibungen des Anfrage-Bodys und den Versionshinweisen.

Erfahren Sie, wie DeepL-Tools die KI‑Übersetzung transformieren, um ein wirklich grenzenloses Business zu ermöglichen.

Intelligentere Berichte mit der DeepL API