Ontvang gedetailleerde rapportages over API-gebruik met de parameter ‘Show billed characters’ van DeepL
Samenvatting
- Gebruikers van de DeepL API kunnen rapporteren over het aantal tekens dat in rekening wordt gebracht voor elk succesvol API-verzoek.
- De parameter `show_billed_characters` geeft gebruikers direct toegang tot API-gebruiksgegevens, rechtstreeks in het API-antwoord.
- De gebruiksgegevens per verzoek kunnen rechtstreeks vanuit de API worden gebruikt bij aangepast rapporteren en workflows voor kostenregistratie.
- Dit is met name handig voor gestructureerde content zoals HTML of XML, waar vertaalbare tekens moeilijker te identificeren kunnen zijn.
- Deze functie breidt de mogelijkheden om over de DeepL API te rapporteren uit tot buiten het /usage-eindpunt en helpt u vertaalactiviteiten nauwkeuriger te monitoren.
- De nieuwe parameter show_billed_characters is al beschikbaar voor alle DeepL API-klanten zonder dat er extra instellingen nodig zijn.
De DeepL API heeft rapportage en analyse altijd als prioriteit gesteld voor ontwikkelaars en bedrijven zoals het uwe. Dit geldt zowel via het /usage-eindpunt direct in de API zelf als via de functionaliteit voor rapporteren voor meerdere API-keys.
Ons team heeft deze handige toevoeging aan onze groeiende lijst met rapportagetools uitgebracht: show_billed_characters is nu beschikbaar voor alle API-klanten.
Dit vormt een aanvulling op de groeiende rapportagefunctionaliteit van de DeepL API. Het biedt nu een gedetailleerd overzicht van het aantal tekens dat in rekening wordt gebracht in de responsgegevens voor elk API-verzoek.
Ontdek hoe de DeepL API u helpt nog meer te doen met onze krachtige Language AI.
Wat is de parameter show_billed_characters?
Voorheen hadden API-gebruikers die nauwkeurige gebruiksgegevens rechtstreeks van de DeepL API wilden ontvangen, slechts één optie: het /usage-eindpunt aanroepen. Dit is een krachtige manier om het meest actuele tekengebruik voor de huidige factureringsperiode op te halen. Het geeft echter geen nauwkeurig overzicht van de tekens die bij elk verzoek worden vertaald.
Een optionele parameter lost dit probleem op door het aantal vertaalde en gefactureerde tekens mee te sturen in het antwoord op elk succesvol API-verzoek.
Ontdek flexibele rapportage op sleutelniveau voor DeepL API-gebruikers.
Hoe werkt de parameter show_billed_characters?
API-klanten die rechtstreeks verzoeken indienen bij de API, bijvoorbeeld via een cURL-commando, kunnen de nieuwe parameter show_billed_characters aan hun verzoeken toevoegen. Dit retourneert het aantal gefactureerde tekens als onderdeel van de responsgegevens.
API-reacties waarbij tekenkosten van toepassing zijn, zullen vervolgens bij elke reactie een nieuwe gehele getalwaarde retourneren in de indeling “billed_characters:50”.
U kunt deze waarde aan de kant van de API-gebruiker bijhouden voor gebruik in werkflows om te rapporteren en om de kosten van elk individueel API-verzoek bij te houden.
Dit is met name belangrijk voor verzoeken die gestructureerde content bevatten, zoals HTML of XML, waarbij het moeilijk kan zijn om de vertaalbare tekens te identificeren.
In de toekomst is het DeepL-team van plan om billed_characters standaard in het API-antwoord op te nemen. Op dat moment zal het nodig zijn om show_billed_characters in te stellen op “false” om “billed_characters” niet op te nemen in het API-antwoord.
Ontdek hoe DeepL de beveiliging versterkt met meerdere API-keys.
Hoe het API-antwoord eruitziet met show_billed_characters
Momenteel krijgt u een reactie die hierop lijkt wanneer u een verzoek naar de API stuurt:
Uw antwoord ziet er als volgt uit als u een verzoek verstuurt met de nieuwe parameter show_billed_characters:
Bekijk de zes vertaaltransformaties waar internationale ondernemingen nu op moeten inspelen.
Waarom DeepL rapportage per verzoek op basis van gefactureerde tekens heeft toegevoegd
Een aantal klanten heeft om deze tool gevraagd. Hiermee kunt u de facturering per teken gedetailleerd rapporteren en die gegevens bij elk succesvol API-vertaalverzoek direct integreren in uw eigen rapportagetools.
De parameter show_billed_characters is volledig operationeel binnen de DeepL API voor gebruikers – er is geen extra configuratie nodig.
Daarnaast hebben we onze API-documentatie bijgewerkt om deze wijziging weer te geven, waardoor het voor ontwikkelaars zoals u eenvoudig is om dit in uw workflows te integreren en te profiteren van een grotere vertaalnauwkeurigheid.
Lees voor meer informatie Beschrijvingen van verzoekteksten en Release-opmerkingen.
Ontdek hoe DeepL-tools AI-vertalingen transformeren voor echt grenzeloze bedrijven.