ແປເອກະສານໄປເປັນ Portuguese API: ຄູ່ມືທີ່ໄວ ແລະ ຖືກຕ້ອງ

ສິ່ງທ້າທາຍຂອງການແປເອກະສານແບບໂປຣແກຣມ

ການເຮັດໃຫ້ການແປໄຟລ໌ Document ຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ ເປັນແບບອັດຕະໂນມັດ ແມ່ນເປັນອຸປະສັກດ້ານເຕັກນິກທີ່ສໍາຄັນສໍາລັບນັກພັດທະນາ.
API ທີ່ມີປະສິດທິພາບໃນການແປ Document ຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ ຕ້ອງເຮັດໄດ້ຫຼາຍກວ່າພຽງແຕ່ແລກປ່ຽນຄໍາສັບ; ມັນຈຳເປັນຕ້ອງຈັດການກັບໂຄງສ້າງທີ່ສັບສົນຂອງໄຟລ໌ຕົ້ນສະບັບ.
ສິ່ງທ້າທາຍເຫຼົ່ານີ້ມັກຈະກ່ຽວຂ້ອງກັບການຮັກສາຮູບແບບທີ່ສັບສົນ, ການຄຸ້ມຄອງການເຂົ້າລະຫັດຂໍ້ຄວາມທີ່ແຕກຕ່າງກັນ, ແລະຮັບປະກັນວ່າເນື້ອຫາທີ່ຝັງຢູ່ທັງໝົດຖືກດໍາເນີນການຢ່າງຖືກຕ້ອງໂດຍບໍ່ມີການເສຍຫາຍ ຫຼື ສູນເສຍ.

ຄວາມລົ້ມເຫຼວໃນການແກ້ໄຂບັນຫາເຫຼົ່ານີ້ສາມາດສົ່ງຜົນໃຫ້ເອກະສານເສຍຫາຍ, ຂໍ້ຄວາມທີ່ບໍ່ສາມາດອ່ານໄດ້, ແລະປະສົບການຂອງຜູ້ໃຊ້ທີ່ບໍ່ດີເຊິ່ງທໍາລາຍຈຸດປະສົງຂອງການແປ.
ຕົວຢ່າງເຊັ່ນ, ສະຄຣິບງ່າຍໆອາດຈະລຶບການຈັດຮູບແບບທີ່ສໍາຄັນອອກໄປ, ເຮັດໃຫ້ຕາຕະລາງ, ແຜນວາດ, ແລະຫົວຂໍ້ຕ່າງໆ ໃຊ້ບໍ່ໄດ້ໃນຜົນໄດ້ຮັບທີ່ແປແລ້ວ.
ນີ້ແມ່ນເຫດຜົນທີ່ວ່າການແກ້ໄຂ API ສະເພາະທາງ ແລະເຂັ້ມແຂງ ບໍ່ພຽງແຕ່ເປັນຄວາມສະດວກເທົ່ານັ້ນ ແຕ່ເປັນສິ່ງຈຳເປັນສຳລັບໂຄງການທ້ອງຖິ່ນຂອງເອກະສານທີ່ມີຄຸນນະພາບສູງ ແລະເປັນມືອາຊີບ ເຊິ່ງຮຽກຮ້ອງຄວາມຊັດເຈນ ແລະຄວາມໜ້າເຊື່ອຖື.

File Encoding Complexities

ໄຟລ໌ Document ສາມາດນໍາໃຊ້ການເຂົ້າລະຫັດຂໍ້ຄວາມຕ່າງໆ, ແລະການຈັດການທີ່ບໍ່ຖືກຕ້ອງໃນລະຫວ່າງການແປແມ່ນເປັນຈຸດທີ່ເຮັດໃຫ້ເກີດຄວາມລົ້ມເຫຼວທົ່ວໄປ.
ພາສາປອກຕຸຍການ, ດ້ວຍເຄື່ອງໝາຍເນັ້ນສຽງເຊັ່ນ ‘ã’, ‘ç’, ແລະ ‘é’, ຕ້ອງການລະບົບການເຂົ້າລະຫັດເຊັ່ນ UTF-8 ເພື່ອສະແດງຢ່າງຖືກຕ້ອງ.
ຖ້າ API ໃຊ້ການເຂົ້າລະຫັດທີ່ເຂົ້າກັນໄດ້ໜ້ອຍ ຫຼື ລົ້ມເຫຼວໃນການກວດຫາການເຂົ້າລະຫັດຕົ້ນສະບັບແບບອັດຕະໂນມັດ, ອັກສອນພິເສດເຫຼົ່ານີ້ສາມາດກາຍເປັນຄວາມຜິດປົກກະຕິ, ນໍາໄປສູ່ຜົນຜະລິດທີ່ບໍ່ມີຄວາມໝາຍ ແລະ ບໍ່ເປັນມືອາຊີບ.

API ການແປພາສາທີ່ຊັບຊ້ອນຕ້ອງຈັດການການເຂົ້າລະຫັດເຫຼົ່ານີ້ຢ່າງສະຫຼາດຕະຫຼອດຂະບວນການທັງໝົດ, ຕັ້ງແຕ່ການວິເຄາະເອກະສານພາສາອັງກິດຕົ້ນສະບັບ ຈົນເຖິງການສ້າງໄຟລ໌ພາສາປອກຕຸຍການສຸດທ້າຍ.
ນີ້ກ່ຽວຂ້ອງກັບການອ່ານໄບຕ໌ຕົ້ນສະບັບຢ່າງຖືກຕ້ອງ, ການປະມວນຜົນເນື້ອໃນຂໍ້ຄວາມໃນຮູບແບບທົ່ວໄປ, ແລະຫຼັງຈາກນັ້ນຂຽນຂໍ້ຄວາມທີ່ແປແລ້ວກັບຄືນໄປບ່ອນໂດຍໃຊ້ການເຂົ້າລະຫັດທີ່ຖືກຕ້ອງສໍາລັບພາສາເປົ້າໝາຍ.
ຖ້າບໍ່ມີການຈັດການທີ່ລະມັດລະວັງນີ້, ນັກພັດທະນາຈະຖືກບັງຄັບໃຫ້ສ້າງການປະມວນຜົນລ່ວງໜ້າ ແລະ ການປະມວນຜົນຫຼັງຂອງຕົນເອງ, ເພີ່ມຄວາມສັບສົນຢ່າງຫຼວງຫຼາຍ ແລະ ທ່າແຮງຂອງຄວາມຜິດພາດໃນການເຮັດວຽກຂອງການລວມເຂົ້າກັນ.

Preserving Complex Layouts

ບາງທີສິ່ງທ້າທາຍທີ່ສໍາຄັນທີ່ສຸດແມ່ນການຮັກສາໂຄງສ້າງ ແລະຮູບແບບທາງສາຍຕາຂອງເອກະສານຕົ້ນສະບັບ.
ເອກະສານບໍ່ຄ່ອຍເປັນພຽງແຕ່ຂໍ້ຄວາມທໍາມະດາ; ພວກມັນມີຫົວຂໍ້, ທ້າຍກະດາດ, ຕາຕະລາງ, ຮູບແບບຫຼາຍຖັນ, ລາຍການ, ແລະຮູບພາບທີ່ມີຄໍາບັນຍາຍ.
ຂະບວນການແປພາສາທີ່ບໍ່ສັບສົນ ເຊິ່ງພຽງແຕ່ດຶງເອົາ ແລະແປສາຍຂໍ້ຄວາມ ຈະທໍາລາຍການຈັດຮູບແບບທີ່ສັບສົນນີ້ຢ່າງຫຼີກລ່ຽງບໍ່ໄດ້, ເຮັດໃຫ້ເອກະສານມີໂຄງສ້າງ ແລະ ຮູບພາບເສຍຫາຍ.

API ການແປເອກະສານຊັ້ນນໍາເຮັດວຽກໂດຍການວິເຄາະໂຄງສ້າງເອກະສານທັງໝົດ, ການກໍານົດໂນດຂໍ້ຄວາມສໍາລັບການແປ ໃນຂະນະທີ່ຮັກສາຮູບແບບ ແລະຂໍ້ມູນການຈັດຮູບແບບໄວ້ຄືເກົ່າ.
ມັນເຂົ້າໃຈຄວາມສໍາພັນລະຫວ່າງອົງປະກອບທີ່ແຕກຕ່າງກັນ, ຮັບປະກັນວ່າປະໂຫຍກທີ່ຖືກແປບໍ່ລົ້ນອອກຈາກຕາຕະລາງຂອງມັນ ຫຼືວ່າລາຍການຍັງຄົງຮັກສາເຄື່ອງໝາຍຈຸດ ແລະ ການຫຍໍ້ໜ້າຕົ້ນສະບັບຂອງມັນ.
ວິທີການທີ່ຮູ້ເຖິງຮູບແບບນີ້ຮັບປະກັນວ່າເອກະສານພາສາປອກຕຸຍການແມ່ນເປັນກະຈົກທີ່ແທ້ຈິງຂອງຕົ້ນສະບັບພາສາອັງກິດ, ພ້ອມສໍາລັບການນໍາໃຊ້ທັນທີໂດຍບໍ່ຮຽກຮ້ອງໃຫ້ມີການຈັດຮູບແບບໃໝ່ດ້ວຍຕົນເອງເປັນຊົ່ວໂມງ.

Handling Embedded Content

ເອກະສານທີ່ທັນສະໄໝມັກຈະມີຫຼາຍກວ່າພຽງແຕ່ຂໍ້ຄວາມ, ລວມທັງຕາຕະລາງ, ຮູບພາບ, ແລະກ່ອງຂໍ້ຄວາມທີ່ຝັງຢູ່.
ແຕ່ລະອົງປະກອບເຫຼົ່ານີ້ສາມາດບັນຈຸເນື້ອຫາທີ່ສາມາດແປໄດ້ ເຊິ່ງຕ້ອງຖືກກໍານົດ ແລະ ປະມວນຜົນຢ່າງຖືກຕ້ອງ.
ຕົວຢ່າງເຊັ່ນ, ປ້າຍຊື່ໃນຕາຕະລາງແຖບ ຫຼືຫົວຂໍ້ໃນກ່ອງຂໍ້ຄວາມ ແມ່ນຂໍ້ມູນທີ່ສໍາຄັນທີ່ຕ້ອງໄດ້ຮັບການແປເປັນພາສາທ້ອງຖິ່ນ ພ້ອມກັບຂໍ້ຄວາມເນື້ອໃນຫຼັກ.

API ທີ່ຖືກສ້າງຂຶ້ນເພື່ອຈຸດປະສົງນີ້ ຕ້ອງສາມາດວິເຄາະໄຟລ໌ໄດ້ຢ່າງເລິກເຊິ່ງ ເພື່ອຊອກຫາ ແລະ ແປຂໍ້ຄວາມຕ່າງໆເຫຼົ່ານີ້.
ມັນຈໍາເປັນຕ້ອງຈັດການວັດຖຸທີ່ຝັງຢູ່ເຫຼົ່ານີ້ໂດຍບໍ່ມີການປ່ຽນແປງຄຸນສົມບັດຮູບພາບ ຫຼືຕໍາແໜ່ງຂອງພວກມັນຢູ່ໃນເອກະສານ.
ນີ້ຮັບປະກັນການແປທີ່ສົມບູນແບບ ເຊິ່ງບໍ່ມີຂໍ້ມູນໃດຖືກປະຖິ້ມໄວ້, ໃຫ້ຜະລິດຕະພັນສຸດທ້າຍທີ່ຖືກແປເປັນພາສາທ້ອງຖິ່ນ ແລະ ຄົບຖ້ວນສໍາລັບຜູ້ໃຊ້ສຸດທ້າຍ.

Introducing the Doctranslate API for Document Translation

Doctranslate API ໄດ້ຖືກອອກແບບມາສະເພາະເພື່ອເອົາຊະນະສິ່ງທ້າທາຍທີ່ສັບສົນເຫຼົ່ານີ້, ສະຫນອງການແກ້ໄຂທີ່ມີປະສິດທິພາບ ແລະເຊື່ອຖືໄດ້ສໍາລັບນັກພັດທະນາ.
ມັນສະຫນອງການໂຕ້ຕອບແບບ RESTful ທີ່ຄ່ອງແຄ້ວສໍາລັບການລວມເອົາຄວາມສາມາດໃນການແປເອກະສານຄຸນນະພາບສູງໂດຍກົງເຂົ້າໃນແອັບພລິເຄເຄຊັນຂອງທ່ານ.
ໂດຍການຈັດການການວິເຄາະໄຟລ໌, ການຮັກສາຮູບແບບ, ແລະ ການຄຸ້ມຄອງການເຂົ້າລະຫັດທີ່ໜັກໜ່ວງ, API ຂອງພວກເຮົາຊ່ວຍໃຫ້ທ່ານສຸມໃສ່ເຫດຜົນຫຼັກຂອງແອັບພລິເຄເຄຊັນຂອງທ່ານ.

ແພລດຟອມຂອງພວກເຮົາຖືກອອກແບບມາສໍາລັບກໍລະນີການນໍາໃຊ້ແບບມືອາຊີບ, ຮັບປະກັນວ່າທຸກການແປຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ ຮັກສາມາດຕະຖານສູງສຸດຂອງຄວາມຖືກຕ້ອງ ແລະ ຄວາມສົມບູນຂອງການຈັດຮູບແບບ.
ດ້ວຍການຮອງຮັບຮູບແບບໄຟລ໌ ແລະ ພາສາທີ່ຫຼາກຫຼາຍ, ທ່ານສາມາດສ້າງແອັບພລິເຄເຄຊັນທີ່ສາມາດປັບຂະໜາດໄດ້, ພ້ອມສໍາລັບທົ່ວໂລກໄດ້ຢ່າງງ່າຍດາຍ.
ສໍາລັບທຸລະກິດທີ່ຊອກຫາເພື່ອເຮັດໃຫ້ການເຮັດວຽກຂອງການແປເປັນພາສາທ້ອງຖິ່ນຂອງພວກເຂົາເປັນແບບອັດຕະໂນມັດ, Doctranslate provides an enterprise-grade platform for instant and accurate document translation, ປະຢັດເວລາ ແລະ ຊັບພະຍາກອນຢ່າງຫຼວງຫຼາຍ.

RESTful Architecture for Simplicity

ສ້າງຂຶ້ນບົນຫຼັກການ REST ມາດຕະຖານ, Doctranslate API ແມ່ນງ່າຍຕໍ່ການລວມເຂົ້າກັນຢ່າງບໍ່ໜ້າເຊື່ອໂດຍໃຊ້ພາສາການຂຽນໂປຣແກຣມທີ່ທັນສະໄໝໃດກໍໄດ້.
ຈຸດປາຍ (Endpoints) ແມ່ນເຂົ້າໃຈງ່າຍ ແລະ ຄາດເດົາໄດ້, ແລະການສື່ສານແມ່ນຖືກຈັດການຜ່ານວິທີການ HTTP ມາດຕະຖານເຊັ່ນ POST ແລະ GET.
ສະຖາປັດຕະຍະກໍາທີ່ຄຸ້ນເຄີຍນີ້ຊ່ວຍຫຼຸດຜ່ອນຄວາມຫຍຸ້ງຍາກໃນການຮຽນຮູ້ຢ່າງຫຼວງຫຼາຍ, ຊ່ວຍໃຫ້ນັກພັດທະນາສາມາດເລີ່ມຕົ້ນ ແລະ ເລີ່ມແປເອກະສານໃນເວລາບໍ່ເທົ່າໃດນາທີ, ບໍ່ແມ່ນມື້.

The API follows a straightforward three-step process: upload, translate, and download.
ການເຮັດວຽກຕາມເຫດຜົນນີ້ແມ່ນງ່າຍດາຍໃນການປະຕິບັດ ແລະ ແກ້ໄຂຂໍ້ບົກພ່ອງ, ໂດຍເອົາຄວາມສັບສົນພື້ນຖານຂອງກົນໄກການແປອອກໄປ.
ບໍ່ວ່າທ່ານກໍາລັງໃຊ້ Python, JavaScript, Java, ຫຼື C#, ການໂຕ້ຕອບກັບ API ຂອງພວກເຮົາຮູ້ສຶກເປັນທໍາມະຊາດ ແລະຮຽກຮ້ອງໃຫ້ມີລະຫັດພື້ນຖານໜ້ອຍທີ່ສຸດ, ເລັ່ງວົງຈອນການພັດທະນາຂອງທ່ານຢ່າງຫຼວງຫຼາຍ.

Reliable JSON Responses

ທຸກຄໍາຮ້ອງຂໍໄປຫາ Doctranslate API ສົ່ງຄືນການຕອບສະຫນອງ JSON ທີ່ສະອາດ, ຄາດເດົາໄດ້.
ມາດຕະຖານນີ້ເຮັດໃຫ້ມັນງ່າຍຕໍ່ການວິເຄາະຜົນໄດ້ຮັບ ແລະ ຈັດການທັງຜົນສໍາເລັດ ແລະ ຂໍ້ຜິດພາດທີ່ອາດຈະເກີດຂຶ້ນແບບໂປຣແກຣມ.
ຕົວລະບຸທີ່ສໍາຄັນ, ເຊັ່ນ `document_id` ແລະ `document_key`, ແມ່ນສະໜອງໃຫ້ເມື່ອອັບໂຫລດ, ຊ່ວຍໃຫ້ທ່ານສາມາດຈັດການ ແລະ ຕິດຕາມສະຖານະຂອງເອກະສານຂອງທ່ານຕະຫຼອດວົງຈອນການແປ.

ການຈັດການຂໍ້ຜິດພາດຍັງຖືກປັບປຸງໃຫ້ດີຂຶ້ນ, ດ້ວຍລະຫັດສະຖານະທີ່ຊັດເຈນ ແລະ ຂໍ້ຄວາມອະທິບາຍທີ່ຊ່ວຍໃຫ້ທ່ານວິນິດໄສບັນຫາຕ່າງໆໄດ້ຢ່າງວ່ອງໄວ.
ຄວາມຫນ້າເຊື່ອຖືນີ້ຮັບປະກັນວ່າທ່ານສາມາດສ້າງແອັບພລິເຄຊັນທີ່ແຂງແຮງ ແລະ ຢືດຢຸ່ນ ເຊິ່ງຈັດການການໂຕ້ຕອບ API ໄດ້ຢ່າງສວຍງາມ.
ທ່ານສາມາດລວມເອົາບໍລິການຂອງພວກເຮົາດ້ວຍຄວາມໝັ້ນໃຈ ໂດຍຮູ້ວ່າທ່ານຈະໄດ້ຮັບຄໍາຄິດເຫັນທີ່ມີໂຄງສ້າງ, ສາມາດອ່ານໄດ້ໂດຍເຄື່ອງຈັກ ສໍາລັບທຸກການຮຽກໃຊ້ API ທີ່ທ່ານເຮັດ.

ຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນໃນການແປ Document ຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ

ການລວມ API ຂອງພວກເຮົາເພື່ອແປ Document ຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ ແມ່ນຂະບວນການທີ່ງ່າຍດາຍ.
ຄູ່ມືນີ້ຈະນໍາພາທ່ານຜ່ານຂັ້ນຕອນທີ່ຈໍາເປັນ, ຕັ້ງແຕ່ການຕັ້ງຄ່າສະພາບແວດລ້ອມຂອງທ່ານ ຈົນເຖິງການດຶງເອົາໄຟລ໌ທີ່ແປແລ້ວສຸດທ້າຍ.
ພວກເຮົາຈະສະໜອງຕົວຢ່າງລະຫັດໃນທັງ Python ແລະ Node.js ເພື່ອສະແດງໃຫ້ເຫັນການລວມເຂົ້າກັນທີ່ຄົບຖ້ວນ ແລະ ເຮັດວຽກໄດ້.

Prerequisites: Getting Your API Key

ກ່ອນທີ່ຈະເຮັດການຮຽກໃຊ້ API ໃດໆ, ທ່ານຈໍາເປັນຕ້ອງໄດ້ຮັບ API key ທີ່ເປັນເອກະລັກຂອງທ່ານ.
key ນີ້ກວດສອບຄວາມຖືກຕ້ອງຂອງຄໍາຮ້ອງຂໍຂອງທ່ານ ແລະເຊື່ອມໂຍງພວກມັນກັບບັນຊີຂອງທ່ານ.
ທ່ານສາມາດຊອກຫາ API key ຂອງທ່ານໄດ້ໃນແຜງຄວບຄຸມ Doctranslate ຂອງທ່ານຫຼັງຈາກລົງທະບຽນສໍາລັບບັນຊີຢູ່ໃນເວັບໄຊທ໌ຂອງພວກເຮົາ.

ຮັກສາ API key ຂອງທ່ານໃຫ້ປອດໄພສະເໝີ ແລະບໍ່ເປີດເຜີຍມັນໃນລະຫັດຝ່າຍລູກຄ້າ.
ຂໍແນະນຳໃຫ້ເກັບມັນໄວ້ເປັນຕົວແປສະພາບແວດລ້ອມ ຫຼືໃຊ້ບໍລິການຈັດການຄວາມລັບ.
ສໍາລັບຕົວຢ່າງຕໍ່ໄປນີ້, ທ່ານຈະຕ້ອງປ່ຽນແທນ `’YOUR_API_KEY’` ດ້ວຍ key ຕົວຈິງຂອງທ່ານ.

Step 1: Uploading Your Document

ຂັ້ນຕອນທໍາອິດແມ່ນການອັບໂຫລດໄຟລ໌ Document ພາສາອັງກິດໄປຫາເຊີບເວີຂອງພວກເຮົາ.
ທ່ານຈະເຮັດຄໍາຮ້ອງຂໍ POST ໄປຫາຈຸດປາຍ `/v2/document/upload`, ສົ່ງໄຟລ໌ເປັນ multipart/form-data.
API ຈະດໍາເນີນການໄຟລ໌ ແລະສົ່ງຄືນ `document_id` ແລະ `document_key`, ເຊິ່ງທ່ານຈະໃຊ້ສໍາລັບຄໍາຮ້ອງຂໍຕໍ່ໄປທັງໝົດທີ່ກ່ຽວຂ້ອງກັບໄຟລ໌ນີ້.

Step 2: Initiating the Translation

ເມື່ອເອກະສານຖືກອັບໂຫລດແລ້ວ, ທ່ານສາມາດຮ້ອງຂໍການແປຂອງມັນໄດ້.
ທ່ານຈະເຮັດຄໍາຮ້ອງຂໍ POST ໄປຫາຈຸດປາຍ `/v2/document/translate`, ໃຫ້ `document_id` ແລະ `document_key` ຈາກຂັ້ນຕອນກ່ອນໜ້ານີ້.
ໃນເນື້ອໃນຄໍາຮ້ອງຂໍ, ທ່ານຕ້ອງລະບຸ `source_lang` ເປັນ ‘en’ ສໍາລັບພາສາອັງກິດ ແລະ `target_lang` ເປັນ ‘pt’ ສໍາລັບພາສາປອກຕຸຍການ.

Step 3: Retrieving the Translated Document

ຫຼັງຈາກຂະບວນການແປສໍາເລັດ, ທ່ານສາມາດດາວໂຫລດໄຟລ໌ Document ພາສາປອກຕຸຍການທີ່ໄດ້ຜົນ.
ທ່ານຈະເຮັດຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດປາຍ `/v2/document/download`, ໂດຍໃຊ້ `document_id` ແລະ `document_key` ອີກເທື່ອໜຶ່ງເພື່ອກໍານົດໄຟລ໌.
API ຈະຕອບສະໜອງດ້ວຍເນື້ອໃນໄຟລ໌ທີ່ຖືກແປແລ້ວ, ເຊິ່ງທ່ານສາມາດບັນທຶກໄວ້ໃນລະບົບທ້ອງຖິ່ນຂອງທ່ານ ຫຼື ໃຫ້ບໍລິການແກ່ຜູ້ໃຊ້ຂອງທ່ານ.

Python Example

import requests
import time

# Your API key and file path
API_KEY = 'YOUR_API_KEY'
FILE_PATH = 'path/to/your/document.docx'

# API endpoints
UPLOAD_URL = 'https://developer.doctranslate.io/v2/document/upload'
TRANSLATE_URL = 'https://developer.doctranslate.io/v2/document/translate'
DOWNLOAD_URL = 'https://developer.doctranslate.io/v2/document/download'

def translate_document():
    # Step 1: Upload the document
    print("ກຳລັງອັບໂຫລດເອກະສານ...")
    with open(FILE_PATH, 'rb') as f:
        files = {'file': (FILE_PATH.split('/')[-1], f)}
        headers = {'Authorization': f'Bearer {API_KEY}'}
        response = requests.post(UPLOAD_URL, headers=headers, files=files)

    if response.status_code != 200:
        print(f"ການອັບໂຫລດລົ້ມເຫຼວ: {response.text}")
        return

    upload_data = response.json()
    document_id = upload_data['document_id']
    document_key = upload_data['document_key']
    print(f"ການອັບໂຫລດສຳເລັດ! Document ID: {document_id}")

    # Step 2: Initiate translation
    print("ກຳລັງລິເລີ່ມການແປເປັນພາສາປອກຕຸຍການ...")
    translate_payload = {
        'document_id': document_id,
        'document_key': document_key,
        'source_lang': 'en',
        'target_lang': 'pt'
    }
    response = requests.post(TRANSLATE_URL, headers=headers, json=translate_payload)

    if response.status_code != 200:
        print(f"ການແປລົ້ມເຫຼວ: {response.text}")
        return

    print("ລິເລີ່ມການແປແລ້ວ. ກຳລັງລໍຖ້າການສຳເລັດ...")
    
    # Step 3: Poll and download the translated document
    while True:
        download_params = {'document_id': document_id, 'document_key': document_key}
        response = requests.get(DOWNLOAD_URL, headers=headers, params=download_params)

        if response.status_code == 200:
            with open('translated_document_pt.docx', 'wb') as f:
                f.write(response.content)
            print("ການແປສຳເລັດ! ໄຟລ໌ຖືກບັນທຶກເປັນ translated_document_pt.docx")
            break
        elif response.status_code == 202:
            print("ການແປຍັງຢູ່ໃນລະຫວ່າງການດໍາເນີນການ, ລໍຖ້າ 5 ວິນາທີ...")
            time.sleep(5)
        else:
            print(f"ການດາວໂຫລດລົ້ມເຫຼວ: {response.text}")
            break

if __name__ == '__main__':
    translate_document()

Node.js (JavaScript) Example

const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');

// Your API key and file path
const API_KEY = 'YOUR_API_KEY';
const FILE_PATH = 'path/to/your/document.docx';

// API endpoints
const UPLOAD_URL = 'https://developer.doctranslate.io/v2/document/upload';
const TRANSLATE_URL = 'https://developer.doctranslate.io/v2/document/translate';
const DOWNLOAD_URL = 'https://developer.doctranslate.io/v2/document/download';

const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));

async function translateDocument() {
    const headers = {
        'Authorization': `Bearer ${API_KEY}`,
    };

    try {
        // Step 1: Upload the document
        console.log('ກຳລັງອັບໂຫລດເອກະສານ...');
        const formData = new FormData();
        formData.append('file', fs.createReadStream(FILE_PATH));

        const uploadResponse = await axios.post(UPLOAD_URL, formData, {
            headers: { ...headers, ...formData.getHeaders() },
        });

        const { document_id, document_key } = uploadResponse.data;
        console.log(`ການອັບໂຫລດສຳເລັດ! Document ID: ${document_id}`);

        // Step 2: Initiate translation
        console.log('ກຳລັງລິເລີ່ມການແປເປັນພາສາປອກຕຸຍການ...');
        const translatePayload = {
            document_id,
            document_key,
            source_lang: 'en',
            target_lang: 'pt',
        };
        await axios.post(TRANSLATE_URL, translatePayload, { headers });
        console.log('ລິເລີ່ມການແປແລ້ວ. ກຳລັງລໍຖ້າການສຳເລັດ...');

        // Step 3: Poll and download the translated document
        while (true) {
            try {
                const downloadResponse = await axios.get(DOWNLOAD_URL, {
                    headers,
                    params: { document_id, document_key },
                    responseType: 'stream',
                });

                if (downloadResponse.status === 200) {
                    const writer = fs.createWriteStream('translated_document_pt.docx');
                    downloadResponse.data.pipe(writer);
                    console.log('ການແປສຳເລັດ! ໄຟລ໌ຖືກບັນທຶກເປັນ translated_document_pt.docx');
                    break;
                }
            } catch (error) {
                if (error.response && error.response.status === 202) {
                    console.log('ການແປຍັງຢູ່ໃນລະຫວ່າງການດໍາເນີນການ, ລໍຖ້າ 5 ວິນາທີ...');
                    await sleep(5000);
                } else {
                    throw error;
                }
            }
        }
    } catch (error) {
        console.error('ເກີດຂໍ້ຜິດພາດ:', error.response ? error.response.data : error.message);
    }
}

translateDocument();

ຂໍ້ຄວນພິຈາລະນາທີ່ສໍາຄັນສໍາລັບການແປພາສາປອກຕຸຍການ
ເມື່ອແປຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ, ຕ້ອງພິຈາລະນາຄວາມແຕກຕ່າງທາງດ້ານພາສາຫຼາຍຢ່າງເພື່ອຮັບປະກັນວ່າຜົນໄດ້ຮັບສຸດທ້າຍບໍ່ພຽງແຕ່ຖືກຕ້ອງ, ແຕ່ຍັງເຫມາະສົມທາງດ້ານວັດທະນະທໍາ ແລະ ບໍລິບົດ.
 ປັດໃຈເຫຼົ່ານີ້ນອກເໜືອໄປຈາກການແປຄຳຕໍ່ຄຳໂດຍກົງ ແລະ ມີຄວາມສຳຄັນຕໍ່ການສື່ສານແບບມືອາຊີບ.
 API ຂອງພວກເຮົາຖືກອອກແບບມາເພື່ອຈັດການຄວາມສັບສົນເຫຼົ່ານີ້, ແຕ່ການຮັບຮູ້ພວກມັນສາມາດຊ່ວຍໃຫ້ທ່ານກວດສອບຜົນໄດ້ຮັບທີ່ດີຂຶ້ນສໍາລັບຜູ້ຊົມສະເພາະຂອງທ່ານ.
Handling Diacritics and Special Characters
ພາສາປອກຕຸຍການໃຊ້ເຄື່ອງໝາຍເນັ້ນສຽງຫຼາຍອັນ, ເຊັ່ນ: cedilla (ç), tilde (ã, õ), ແລະສໍານຽງຕ່າງໆ (á, â, à, é, ê, í, ó, ô, ú).
 ດັ່ງທີ່ໄດ້ກ່າວມາຂ້າງເທິງ, ການເຂົ້າລະຫັດ UTF-8 ທີ່ເໝາະສົມແມ່ນຈໍາເປັນເພື່ອປ້ອງກັນບໍ່ໃຫ້ຕົວອັກສອນເຫຼົ່ານີ້ເສຍຫາຍ.
 The Doctranslate API handles this automatically, ensuring that all special characters are preserved correctly in the final translated document.
ຄວາມເອົາໃຈໃສ່ຕໍ່ລາຍລະອຽດນີ້ປ້ອງກັນຄວາມຜິດພາດທີ່ໜ້າອັບອາຍ ແລະ ບໍ່ເປັນມືອາຊີບ ເຊິ່ງສາມາດເຮັດໃຫ້ຂໍ້ຄວາມອ່ານຍາກ ຫຼື ເຖິງແມ່ນປ່ຽນຄວາມໝາຍຂອງຄໍາສັບ.
 ສໍາລັບນັກພັດທະນາ, ນີ້ໝາຍຄວາມວ່າທ່ານບໍ່ຈໍາເປັນຕ້ອງຂຽນເຫດຜົນການເຂົ້າລະຫັດ ຫຼື ການຖອດລະຫັດພິເສດໃດໆໃນແອັບພລິເຄຊັນຂອງທ່ານ.
 ທ່ານສາມາດໄວ້ວາງໃຈໄດ້ວ່າໄຟລ໌ຜົນຜະລິດຈະຖືກຈັດຮູບແບບຢ່າງຖືກຕ້ອງ ແລະ ພ້ອມສໍາລັບການນໍາໃຊ້ໂດຍຜູ້ເວົ້າພາສາປອກຕຸຍການພື້ນເມືອງ.
Formal vs. Informal Tone (Tu vs. Você)
ພາສາປອກຕຸຍການມີລະດັບຄວາມເປັນທາງການທີ່ແຕກຕ່າງກັນ, ສັງເກດໄດ້ຫຼາຍທີ່ສຸດໃນຄໍາສັບແທນຊື່ບຸກຄົນທີສອງຂອງມັນ.
 ໃນປະເທດບຣາຊິນ, ‘você’ ຖືກນໍາໃຊ້ຢ່າງກວ້າງຂວາງສໍາລັບທັງບໍລິບົດທີ່ເປັນທາງການ ແລະ ບໍ່ເປັນທາງການ, ໃນຂະນະທີ່ໃນ European Portuguese, ‘tu’ ແມ່ນທົ່ວໄປສໍາລັບການກ່າວເຖິງທີ່ບໍ່ເປັນທາງການ ແລະ ‘você’ ແມ່ນເປັນທາງການຫຼາຍກວ່າ.
 ການເລືອກລະຫວ່າງພວກມັນແມ່ນຂຶ້ນກັບຜູ້ຊົມເປົ້າໝາຍ ແລະ ບໍລິບົດຂອງເອກະສານ.
ໃນຂະນະທີ່ເຄື່ອງຈັກການແປຂອງພວກເຮົາຮັບຮູ້ເຖິງບໍລິບົດ, ມັນເປັນການປະຕິບັດທີ່ດີທີ່ຈະທົບທວນເອກະສານທີ່ມີຈຸດປະສົງສໍາລັບພາກພື້ນ ຫຼື ຜູ້ຊົມສະເພາະ.
 ຖ້າເນື້ອໃນຂອງທ່ານເປັນທາງການສູງ, ເຊັ່ນ: ສັນຍາທາງກົດໝາຍ, ຫຼື ບໍ່ເປັນທາງການຫຼາຍ, ເຊັ່ນ: ເອກະສານການຕະຫຼາດສໍາລັບຜູ້ຊົມໄວໜຸ່ມ, ການທົບທວນໂດຍມະນຸດຄັ້ງສຸດທ້າຍສາມາດເພີ່ມລະດັບຄວາມສົມບູນແບບອີກຊັ້ນໜຶ່ງ.
 ການເຂົ້າໃຈຄວາມແຕກຕ່າງນີ້ຊ່ວຍໃນການກໍານົດນໍ້າສຽງທີ່ຖືກຕ້ອງສໍາລັບເນື້ອຫາທີ່ແປເປັນພາສາທ້ອງຖິ່ນຂອງທ່ານ.
Nuances in Brazilian vs. European Portuguese
ນອກເໜືອໄປຈາກຄໍາສັບແທນຊື່, ຍັງມີຄວາມແຕກຕ່າງດ້ານຄໍາສັບ ແລະ ໄວຍະກອນທີ່ສໍາຄັນລະຫວ່າງ Brazilian Portuguese (PT-BR) ແລະ European Portuguese (PT-PT).
 ຕົວຢ່າງເຊັ່ນ, ‘bus’ ແມ່ນ ‘ônibus’ ໃນປະເທດບຣາຊິນ ແຕ່ ‘autocarro’ ໃນປະເທດປອກຕຸຍການ.
 ການນໍາໃຊ້ຕົວແປທີ່ບໍ່ຖືກຕ້ອງສາມາດເຮັດໃຫ້ເນື້ອຫາຂອງທ່ານຮູ້ສຶກແປກປະຫຼາດສໍາລັບຜູ້ຊົມເປົ້າໝາຍ.
API ຂອງພວກເຮົາອະນຸຍາດໃຫ້ລະບຸຕົວແປພາກພື້ນ ເພື່ອຮັບປະກັນວ່າການແປແມ່ນຖືກປັບໃຫ້ເໝາະສົມກັບຕະຫຼາດເປົ້າໝາຍຂອງທ່ານ.
 ເມື່ອລິເລີ່ມການແປ, ທ່ານສາມາດລະບຸ `pt-BR` ຫຼື `pt-PT` ເປັນ `target_lang` ສໍາລັບການແປເປັນພາສາທ້ອງຖິ່ນທີ່ຊັດເຈນກວ່າ.
 ລະດັບການຄວບຄຸມນີ້ແມ່ນມີຄວາມສໍາຄັນສໍາລັບທຸລະກິດທີ່ມີເປົ້າໝາຍເພື່ອສ້າງຄວາມຜູກພັນທີ່ເຂັ້ມແຂງກັບຜູ້ຊົມຂອງພວກເຂົາໃນປະເທດສະເພາະ, ຮັບປະກັນວ່າພາສາຮູ້ສຶກເປັນທໍາມະຊາດ ແລະ ເປັນຂອງແທ້.
ບົດສະຫຼຸບ ແລະ ຂັ້ນຕອນຕໍ່ໄປ
ການລວມເອົາ API ທີ່ມີປະສິດທິພາບເພື່ອແປໄຟລ໌ Document ຈາກພາສາອັງກິດໄປເປັນພາສາປອກຕຸຍການ ແມ່ນຂັ້ນຕອນການປ່ຽນແປງສໍາລັບທຸລະກິດທົ່ວໂລກໃດໆ.
 The Doctranslate API simplifies this complex task by providing a robust, developer-friendly solution that preserves document formatting and handles linguistic nuances with precision.
 ໂດຍການປະຕິບັດຕາມຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນ ແລະ ການນໍາໃຊ້ຕົວຢ່າງລະຫັດຂອງພວກເຮົາ, ທ່ານສາມາດເຮັດໃຫ້ການເຮັດວຽກການແປຂອງທ່ານເປັນແບບອັດຕະໂນມັດໄດ້ຢ່າງວ່ອງໄວ ແລະ ສົ່ງມອບເນື້ອຫາທີ່ແປເປັນພາສາທ້ອງຖິ່ນທີ່ມີຄຸນນະພາບສູງ.
ບົດຄວາມນີ້ໄດ້ກວມເອົາສິ່ງທ້າທາຍຕົ້ນຕໍຂອງການແປເອກະສານແບບໂປຣແກຣມ ແລະ ໄດ້ສະແດງໃຫ້ເຫັນວ່າ API ຂອງພວກເຮົາແກ້ໄຂພວກມັນໄດ້ຢ່າງມີປະສິດທິພາບແນວໃດ.
 ຕັ້ງແຕ່ການຄຸ້ມຄອງການເຂົ້າລະຫັດໄຟລ໌ ແລະ ຮູບແບບຕ່າງໆ ຈົນເຖິງການສະໜອງຂໍ້ຄວນພິຈາລະນາສະເພາະສໍາລັບພາສາປອກຕຸຍການ, ຕອນນີ້ທ່ານມີຄວາມຮູ້ໃນການສ້າງການລວມເຂົ້າກັນແບບບໍ່ມີຂໍ້ບົກພ່ອງ.
 ພວກເຮົາຂໍແນະນໍາໃຫ້ທ່ານຄົ້ນຫາເອກະສານ API ຢ່າງເປັນທາງການຂອງພວກເຮົາສໍາລັບຄຸນສົມບັດຂັ້ນສູງເພີ່ມເຕີມ ແລະ ລາຍການພາສາ ແລະ ປະເພດໄຟລ໌ທີ່ຮອງຮັບຢ່າງຄົບຖ້ວນ ເພື່ອປັບປຸງແອັບພລິເຄຊັນຂອງທ່ານໃຫ້ດີຍິ່ງຂຶ້ນ.