Få detaljerade rapporter om API-användningen med DeepL:s parameter ”Visa fakturerade tecken”

Viktiga slutsatser

• DeepL API-användare kan rapportera antalet tecken som faktureras för varje lyckad API-förfrågan.
• Parametern show_billed_characters ger användarna omedelbar tillgång till API-användningsdata direkt i API-svaret.
• Denna användningsdata per förfrågan kan användas i anpassade rapporterings- och kostnadsspårningsflöden direkt från API:et.
• Detta är särskilt användbart för strukturerat innehåll som HTML eller XML, där översättningsbara tecken kan vara svårare att identifiera.
• Funktionerna utökar DeepL API-rapporteringen bortom /usage-slutpunkten och hjälper dig att övervaka översättningsaktiviteten med större precision.
• Den nya parametern show_billed_characters är redan tillgänglig för alla DeepL API-kunder utan ytterligare konfiguration.

DeepL API har alltid prioriterat rapportering och analys för utvecklare och företag som ditt. Detta gäller oavsett om det sker via /usage-slutpunkten direkt i själva API:et eller via rapporteringsfunktionen för flera API-nycklar.

Vårt team har släppt detta praktiska tillskott till vår växande lista över rapporteringsverktyg: show_billed_characters är nu tillgängligt för alla API-kunder.

Detta utökar DeepL API:s växande rapporteringsfunktioner. Det möjliggör nu en detaljerad översikt över hur många tecken som faktureras i svarsdata för varje API-förfrågan.

Upptäck hur DeepL API hjälper dig att göra ännu mer med vår kraftfulla Språk-AI.

Vad är parametern show_billed_characters?

Tidigare hade API-användare som ville få exakta användningsdata direkt från DeepL API ett enda alternativ för att anropa /usage-slutpunkten. Detta är ett effektivt sätt att hämta den senaste teckenanvändningen för den aktuella faktureringsperioden. Det ger dock ingen exakt uppdelning av de tecken som översätts i varje förfrågan.

En valfri parameter löser detta problem genom att returnera antalet översatta och fakturerade tecken i svaret på varje lyckad API-förfrågan.

Upptäck flexibel rapportering på nyckelnivå för DeepL API-användare.

Hur fungerar parametern show_billed_characters?

API-kunder som gör förfrågningar direkt till API:et, till exempel via ett cURL-kommando, kan lägga till den nya parametern show_billed_characters i sina förfrågningar. Detta returnerar antalet fakturerade tecken som en del av svarsdata. 

API-svar som innefattar en teckenkostnad returnerar då ett nytt heltal i formatet ”billed_characters:50” med varje svar.

Du kan spåra detta värde på API-användarens sida för användning i rapporteringsflöden och för att spåra kostnaden för varje enskild API-förfrågan.

Detta är särskilt viktigt för förfrågningar som innehåller strukturerat innehåll som HTML eller XML, där det kan vara svårt att identifiera de översättningsbara tecknen.

I framtiden avser DeepL-teamet att inkludera billed_characters i API-svaret som standard. Då blir det nödvändigt att ställa in show_billed_characters till ”false” för att inte inkludera ”billed_characters” i API-svaret.

Läs om hur DeepL stärker säkerheten med flera API-nycklar.

Hur API-svaret ser ut med show_billed_characters

För närvarande får du ett svar som liknar detta när du skickar en begäran till API:et:

Ditt svar kommer att se ut så här om du skickar en förfrågan med den nya parametern show_billed_characters:

Se de sex översättningsförändringar som globala företag bör ta till sig nu.

Varför DeepL har lagt till rapportering av fakturerade tecken per förfrågan

Ett antal kunder har efterfrågat detta verktyg. Det låter dig rapportera teckenfakturering på ett detaljerat sätt och integrera den informationen direkt i dina egna rapporteringsverktyg vid varje lyckad API-översättningsförfrågan.

Parametern show_billed_characters är fullt fungerande inom DeepL API för användare – ingen ytterligare konfiguration krävs. 

Dessutom har vi uppdaterat vår API-dokumentation för att återspegla denna förändring, vilket gör det enkelt för utvecklare som du att integrera detta i dina arbetsflöden och att börja dra nytta av högre översättningsnoggrannhet.

För mer information, läs Beskrivningar av förfrågningskroppen och Release Notes.

Se hur DeepL:s verktyg förändrar AI-översättning för ett verkligt gränslöst företag.

Skapa smartare rapportering med DeepL API

DeepL API ger dig ett flexibelt sätt att bädda in högkvalitativa översättningar direkt i dina egna verktyg. Med funktioner som show_billed_characters kan du kombinera den översättningskraften med mer precisa användningsrapporter och kostnadsöversikt. 

Det ingår i samma Språk-AI-paket som driver Translator, Write och Voice – så när dina översättningsbehov växer, skalar den underliggande infrastrukturen med dig. 

Utforska DeepL API, eller kontakta säljavdelningen för att diskutera företagets rapporterings- och integrationsbehov.