Získejte podrobné přehledy o využití API díky parametru „Zobrazit účtované znaky“ od DeepL
Hlavní poznatky
- Uživatelé DeepL API mohou nahlásit počet znaků účtovaných za každý úspěšný požadavek API.
- Parametr show_billed_characters poskytuje uživatelům okamžitý přístup k údajům o využití API přímo v odpovědi API.
- Tato data o využití na jednotlivé požadavky lze použít v pracovních postupech pro vytváření vlastních reportů a sledování nákladů přímo z API.
- To je obzvláště užitečné pro strukturovaný obsah, jako je HTML nebo XML, kde může být identifikace překladatelných znaků obtížnější.
- Tato funkce rozšiřuje možnosti reportování DeepL API nad rámec koncového bodu /usage a pomáhá vám sledovat překladatelskou činnost s větší přesností.
- Nový parametr show_billed_characters je již k dispozici všem zákazníkům DeepL API bez nutnosti dalšího nastavení.
DeepL API vždy kladlo důraz na reportování a analýzu jako prioritu pro vývojáře a obchodní firmy, jako je ta vaše. To platí ať už prostřednictvím koncového bodu /usage přímo v samotném API, nebo prostřednictvím funkce nahlášení pro více klíčů API.
Náš tým vydal tento praktický přírůstek do našeho rostoucího seznamu nástrojů pro reportování: show_billed_characters je nyní k dispozici všem zákazníkům API.
Tím se rozšiřují rostoucí funkce reportování DeepL API. Nyní umožňuje detailní přehled o tom, kolik znaků je účtováno v datech odpovědi pro každý požadavek API.
Zjistěte, jak vám DeepL API pomůže dosáhnout ještě více s naší výkonnou Jazykovou AI.
Co je parametr show_billed_characters?
Dříve měli uživatelé API, kteří chtěli získat přesné údaje o využití přímo z DeepL API, jedinou možnost, a to volání koncového bodu /usage. Jedná se o výkonný způsob, jak získat nejaktuálnější údaje o využití znaků za aktuální fakturační období. Neposkytuje však přesný rozpis znaků překládaných v každém požadavku.
Tento problém řeší volitelný parametr, který v odpovědi na každý úspěšný požadavek API vrací počet přeložených a vyúčtovaných znaků.
Objevte flexibilní reportování na úrovni klíčů pro uživatele DeepL API.
Jak funguje parametr show_billed_characters?
Zákazníci API, kteří odesílají požadavky přímo na API, například pomocí příkazu cURL, mohou do svých požadavků přidat nový parametr show_billed_characters. Ten vrátí počet zúčtovaných znaků jako součást dat odpovědi.
Odpovědi API, u nichž se účtují náklady za znaky, pak v každé odpovědi vrátí novou celočíselnou hodnotu ve formátu „billed_characters:50“.
Tuto hodnotu můžete sledovat na straně uživatele API pro použití v pracovních postupech reportování a pro sledování nákladů na každý jednotlivý požadavek API.
To je obzvláště důležité u požadavků obsahujících strukturovaný obsah, jako je HTML nebo XML, kde může být obtížné identifikovat překladatelné znaky.
V budoucnu tým DeepL plánuje zahrnout „billed_characters“ do odpovědi API jako výchozí nastavení. V tom okamžiku bude nutné nastavit show_billed_characters na „false“, aby se „billed_characters“ nezahrnovalo do odpovědi API.
Zjistěte, jak DeepL posiluje bezpečnost pomocí více klíčů API.
Jak vypadá odpověď API s show_billed_characters
V současné době obdržíte při odeslání požadavku na API podobnou odpověď:
Vaše odpověď bude vypadat takto, pokud odešlete požadavek s použitím nového parametru show_billed_characters:
Podívejte se na šest překladatelských transformací, které by globální podniky měly využít hned teď.
Proč DeepL přidal reportování účtovaných znaků na požadavek
O tento nástroj požádalo řada zákazníků. Umožňuje vám podrobně nahlásit fakturaci znaků a integrovat tato data přímo do vašich vlastních nástrojů pro reporting při každém úspěšném překladatelském požadavku na API.
Parametr show_billed_characters je pro uživatele DeepL v rámci DeepL API plně funkční – není nutné žádné další nastavení.
Kromě toho jsme aktualizovali naši dokumentaci API, aby odrážela tuto změnu, což vývojářům, jako jste vy, usnadní integraci této funkce do vašich pracovních postupů a začnete těžit z vyšší přesnosti překladu.
Další informace najdete v Popis těla požadavku a Poznámky k verzi.