Dapatkan laporan penggunaan API yang terperinci dengan parameter "Show Billed Characters" dari DeepL API
Poin Utama
- Pengguna DeepL API dapat membuat laporan tentang jumlah karakter yang ditagih untuk setiap permintaan API yang berhasil.
- Parameter `show_billed_characters` memberikan akses langsung kepada pengguna ke data penggunaan API langsung dalam respons API.
- Data penggunaan per permintaan tersebut dapat digunakan dalam laporan khusus dan alur kerja pelacakan biaya langsung dari API.
- Hal ini sangat berguna untuk konten terstruktur seperti HTML atau XML, di mana karakter yang dapat diterjemahkan mungkin lebih sulit diidentifikasi.
- Fitur ini memperluas laporan DeepL API melampaui endpoint /usage dan membantu Anda memantau aktivitas terjemahan dengan lebih akurat.
- Parameter show_billed_characters yang baru sudah tersedia untuk semua pelanggan DeepL API tanpa pengaturan tambahan.
DeepL API selalu mengutamakan laporan dan analisis bagi pengembang dan bisnis seperti milik Anda. Hal ini berlaku baik melalui endpoint /usage langsung di API itu sendiri maupun melalui fungsi laporan untuk beberapa API key.
Tim kami merilis tambahan yang praktis ini ke dalam daftar alat laporan kami yang terus berkembang: show_billed_characters kini tersedia bagi semua pelanggan API.
Hal ini menambah fungsionalitas laporan DeepL API yang terus berkembang. Fitur ini kini memungkinkan tampilan terperinci mengenai berapa banyak karakter yang ditagih dalam data respons untuk setiap permintaan API.
Apa itu parameter show_billed_characters?
Sebelumnya, pengguna API yang ingin mendapatkan data penggunaan yang akurat langsung dari DeepL API hanya memiliki satu opsi untuk memanggil endpoint /usage. Ini adalah cara yang ampuh untuk mengambil penggunaan karakter terbaru untuk periode penagihan yang sedang berlangsung. Namun, cara ini tidak memberikan rincian akurat mengenai karakter yang diterjemahkan dalam setiap permintaan.
Parameter opsional memecahkan masalah ini dengan mengembalikan jumlah karakter yang diterjemahkan dan ditagih bersama respons dari setiap permintaan API yang berhasil.
Temukan laporan tingkat kunci yang fleksibel untuk pengguna DeepL API.
Bagaimana cara kerja parameter show_billed_characters?
Pelanggan API yang membuat permintaan langsung ke API, seperti melalui perintah cURL, dapat menambahkan parameter show_billed_characters baru ke permintaan mereka. Ini akan mengembalikan jumlah karakter yang ditagih sebagai bagian dari data respons.
Respons API yang melibatkan biaya karakter kemudian akan mengembalikan nilai integer baru dalam format “billed_characters:50” pada setiap respons.
Anda dapat melacak nilai ini di sisi pengguna API untuk digunakan dalam alur kerja laporan dan untuk melacak biaya setiap permintaan API.
Hal ini sangat penting untuk permintaan yang berisi konten terstruktur seperti HTML atau XML, di mana mungkin sulit untuk mengidentifikasi karakter yang dapat diterjemahkan.
Di masa mendatang, tim DeepL berencana untuk menyertakan billed_characters dalam respons API secara default. Pada saat itu, Anda perlu menyetel show_billed_characters ke “false” agar “billed_characters” tidak disertakan dalam respons API.
Pelajari bagaimana DeepL memperkuat keamanan dengan beberapa API key.
Tampilan respons API dengan show_billed_characters
Saat ini, Anda akan mendapatkan respons serupa dengan ini saat mengirim permintaan ke API:
Respons Anda akan terlihat seperti ini jika Anda mengirimkan permintaan menggunakan parameter show_billed_characters yang baru:
Lihat enam transformasi terjemahan yang harus dimanfaatkan oleh perusahaan global saat ini.
Mengapa DeepL menambahkan laporan karakter yang ditagih per permintaan
Sejumlah pelanggan telah meminta alat ini. Alat ini memungkinkan Anda melacak penagihan karakter secara terperinci dan mengintegrasikan data tersebut langsung ke alat laporan Anda sendiri setiap kali permintaan terjemahan API berhasil.
Parameter show_billed_characters sudah sepenuhnya beroperasi dalam API untuk pengguna DeepL—tidak diperlukan pengaturan tambahan.
Selain itu, kami telah memperbarui dokumentasi API kami untuk mencerminkan perubahan ini, sehingga memudahkan pengembang seperti Anda untuk mengintegrasikannya ke dalam alur kerja Anda dan mulai mendapatkan manfaat dari akurasi terjemahan yang lebih baik.
Untuk informasi lebih lanjut, baca Deskripsi Badan Permintaan dan Catatan Rilis.
Lihat bagaimana alat DeepL mengubah terjemahan AI untuk bisnis yang benar-benar tanpa batas.