API ແປເອກະສານ: ຄູ່ມືພາສາອັງກິດຫາພາສາປອກຕຸຍການ | ໄວ

ເປັນຫຍັງການແປເອກະສານຜ່ານ API ຈຶ່ງເປັນສິ່ງທ້າທາຍທີ່ສັບສົນ

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

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

ການຈັດການຮູບແບບໄຟລ໌ທີ່ຫຼາກຫຼາຍ ແລະ ຊັບຊ້ອນ

ອຸປະສັກໃຫຍ່ທຳອິດທີ່ນັກພັດທະນາພົບແມ່ນຄວາມຫຼາກຫຼາຍຂອງຮູບແບບໄຟລ໌ທີ່ໃຊ້ໃນການສື່ສານທາງທຸລະກິດ.
ເອກະສານຕ່າງໆສາມາດຕັ້ງແຕ່ Microsoft Word (.docx) ແລະ Adobe PDF (.pdf) ໄປຫາການນໍາສະເໜີ PowerPoint (.pptx) ແລະຕາຕະລາງ Excel (.xlsx).
ຮູບແບບເຫຼົ່ານີ້ແຕ່ລະອັນມີໂຄງສ້າງພາຍໃນທີ່ເປັນເອກະລັກ, ດ້ວຍວິທີການເກັບຮັກສາຂໍ້ຄວາມ, ຂໍ້ມູນຮູບແບບ, ແລະສື່ທີ່ຝັງໄວ້ຂອງມັນເອງ, ເຮັດໃຫ້ວິທີການທີ່ເໝາະສົມກັບທຸກຢ່າງເປັນໄປບໍ່ໄດ້.

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

ການຮັກສາຮູບແບບ ແລະ ການຈັດຮູບແບບທາງສາຍຕາ

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

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

ການເຂົ້າລະຫັດຕົວອັກສອນ ແລະ ຕົວອັກສອນພິເສດ

ຕົວອັກສອນສະເພາະພາສາສະເໜີອຸປະສັກທາງດ້ານເຕັກນິກທີ່ສໍາຄັນອີກອັນຫນຶ່ງໃນທໍ່ສົ່ງການແປ.
ພາສາປອກຕຸຍການໃຊ້ເຄື່ອງໝາຍ diacritics ແລະຕົວອັກສອນພິເສດຫຼາຍອັນ, ເຊັ່ນ: `ç`, `ã`, `é`, ແລະ `ô`, ເຊິ່ງບໍ່ມີຢູ່ໃນຕົວອັກສອນພາສາອັງກິດມາດຕະຖານ.
ຖ້າລະບົບການແປບໍ່ຈັດການການເຂົ້າລະຫັດຕົວອັກສອນຢ່າງຖືກຕ້ອງ, ໂດຍປົກກະຕິແລ້ວແມ່ນໃຊ້ມາດຕະຖານສາກົນເຊັ່ນ UTF-8, ຕົວອັກສອນເຫຼົ່ານີ້ສາມາດກາຍເປັນຂໍ້ຄວາມຜິດປົກກະຕິ ຫຼືຖືກແທນທີ່ດ້ວຍສັນຍາລັກທີ່ບໍ່ມີຄວາມໝາຍ.

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

ແນະນໍາ Doctranslate API ສໍາລັບການແປເອກະສານ

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

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

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

ຄູ່ມືເທື່ອລະຂັ້ນຕອນ: ການເຊື່ອມໂຍງ Document Translation API (ພາສາອັງກິດຫາພາສາປອກຕຸຍການ)

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

ຂັ້ນຕອນທີ 1: ການເອົາ API Key ຂອງທ່ານ

ກ່ອນທີ່ທ່ານຈະສາມາດເຮັດການຮ້ອງຂໍໃດໆ, ທ່ານຈໍາເປັນຕ້ອງກວດສອບແອັບພລິເຄຊັນຂອງທ່ານດ້ວຍ API key ທີ່ເປັນເອກະລັກ.
ເພື່ອເອົາ key ຂອງທ່ານ, ທ່ານຈະຕ້ອງສ້າງບັນຊີໃນແພລດຟອມ Doctranslate ກ່ອນ.
ເມື່ອລົງທະບຽນແລ້ວ, ໃຫ້ໄປທີ່ພາກສ່ວນນັກພັດທະນາຂອງ dashboard ຂອງທ່ານ, ບ່ອນທີ່ທ່ານຈະພົບເຫັນ API key ຂອງທ່ານພ້ອມທີ່ຈະໃຊ້ສໍາລັບການຮ້ອງຂໍທັງໝົດຂອງທ່ານ.

Key ນີ້ຕ້ອງຖືກລວມຢູ່ໃນ `Authorization` header ຂອງການໂທ API ທຸກຄັ້ງທີ່ທ່ານເຮັດ, ໂດຍໃຊ້ລະບົບ Bearer authentication.
ໃຫ້ແນ່ໃຈວ່າຈະຮັກສາ API key ຂອງທ່ານໃຫ້ປອດໄພ ແລະບໍ່ເປີດເຜີຍມັນຢູ່ໃນ client-side code ຫຼື public repositories.
ໃຫ້ຖືວ່າມັນເປັນຄືກັບລະຫັດຜ່ານ, ເນື່ອງຈາກວ່າມັນໃຫ້ສິດເຂົ້າເຖິງບັນຊີຂອງທ່ານ ແລະເຄຣດິດການນໍາໃຊ້ທີ່ກ່ຽວຂ້ອງ.

ຂັ້ນຕອນທີ 2: ການກະກຽມເອກະສານຂອງທ່ານ

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

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

ຂັ້ນຕອນທີ 3: ການອັບໂຫລດ ແລະ ການເລີ່ມຕົ້ນການແປ (ຕົວຢ່າງ Python)

ຂະບວນການແປເລີ່ມຕົ້ນດ້ວຍການອັບໂຫລດເອກະສານຂອງທ່ານໄປທີ່ endpoint `/v3/documents` ໂດຍໃຊ້ການຮ້ອງຂໍ `POST`.
ການຮ້ອງຂໍນີ້ຕ້ອງເປັນ `multipart/form-data` request, ເພາະວ່າມັນລວມເອົາຂໍ້ມູນໄຟລ໌ binary ພ້ອມກັບ metadata ເຊັ່ນພາສາຕົ້ນສະບັບ ແລະ ພາສາເປົ້າໝາຍ.
ນອກຈາກນີ້ທ່ານຍັງຈະຕ້ອງສະໜອງ API key ຂອງທ່ານໃນ headers ສໍາລັບການກວດສອບ.

ໃນ request body, ທ່ານຈະກໍານົດ `source_language` ເປັນ `en` ສໍາລັບພາສາອັງກິດ ແລະ `target_language` ເປັນ `pt` ສໍາລັບພາສາປອກຕຸຍການ.
ທ່ານຍັງສາມາດລວມເອົາພາຣາມິດເຕີທາງເລືອກເຊັ່ນ `formality` ເພື່ອຄວບຄຸມສຽງຂອງການແປ, ເຊິ່ງເປັນປະໂຫຍດໂດຍສະເພາະສໍາລັບພາສາປອກຕຸຍການ.
ດ້ານລຸ່ມນີ້ແມ່ນສະຄຣິບ Python ທີ່ສົມບູນເຊິ່ງສະແດງໃຫ້ເຫັນວິທີການອັບໂຫລດໄຟລ໌, ສອບຖາມສະຖານະຂອງມັນ, ແລະດາວໂຫລດຜົນໄດ້ຮັບ.

import requests
import time
import os

# --- Configuration ---
API_KEY = "YOUR_API_KEY" # Replace with your actual API key
BASE_URL = "https://developer.doctranslate.io/v3"
FILE_PATH = "path/to/your/document.docx" # Replace with your document path
SOURCE_LANG = "en"
TARGET_LANG = "pt"
FORMALITY = "formal" # or "informal"

# --- Step 1: Upload Document for Translation ---
def upload_document():
    print(f"Uploading {os.path.basename(FILE_PATH)} for translation...")
    headers = {
        "Authorization": f"Bearer {API_KEY}"
    }
    files = {
        "document": (os.path.basename(FILE_PATH), open(FILE_PATH, "rb"))
    }
    data = {
        "source_language": SOURCE_LANG,
        "target_language": TARGET_LANG,
        "formality": FORMALITY
    }
    
    response = requests.post(f"{BASE_URL}/documents", headers=headers, files=files, data=data)
    
    if response.status_code == 201:
        document_data = response.json()
        print("Upload successful!")
        print(f"Document ID: {document_data['id']}")
        return document_data['id']
    else:
        print(f"Error uploading document: {response.status_code}")
        print(response.text)
        return None

# --- Step 2: Poll for Translation Status ---
def check_status(document_id):
    print("Checking translation status...")
    headers = {
        "Authorization": f"Bearer {API_KEY}"
    }
    
    while True:
        response = requests.get(f"{BASE_URL}/documents/{document_id}", headers=headers)
        if response.status_code == 200:
            status_data = response.json()
            current_status = status_data['status']
            print(f"Current status: {current_status}")
            
            if current_status == "done":
                print("Translation complete!")
                return True
            elif current_status == "error":
                print("Translation failed.")
                return False
            
            # Wait for 10 seconds before polling again
            time.sleep(10)
        else:
            print(f"Error checking status: {response.status_code}")
            return False

# --- Step 3: Download Translated Document ---
def download_result(document_id):
    print("Downloading translated document...")
    headers = {
        "Authorization": f"Bearer {API_KEY}"
    }
    
    response = requests.get(f"{BASE_URL}/documents/{document_id}/result", headers=headers)
    
    if response.status_code == 200:
        output_filename = f"translated_{os.path.basename(FILE_PATH)}"
        with open(output_filename, "wb") as f:
            f.write(response.content)
        print(f"Translated document saved as {output_filename}")
    else:
        print(f"Error downloading result: {response.status_code}")
        print(response.text)

# --- Main Execution ---
if __name__ == "__main__":
    doc_id = upload_document()
    if doc_id:
        if check_status(doc_id):
            download_result(doc_id)

ຂັ້ນຕອນທີ 4: ການກວດສອບສະຖານະການແປ
ຫຼັງຈາກທີ່ທ່ານອັບໂຫລດເອກະສານສໍາເລັດແລ້ວ, API ຈະສົ່ງຄືນການຕອບສະໜອງ JSON ທີ່ປະກອບດ້ວຍ `id` ທີ່ເປັນເອກະລັກສໍາລັບວຽກການແປຂອງທ່ານ.
 ທ່ານຈະໃຊ້ `document_id` ນີ້ເພື່ອກວດສອບຄວາມຄືບໜ້າຂອງການແປ, ເນື່ອງຈາກຂະບວນການຖືກຈັດການແບບ asynchronous.
 ເພື່ອເຮັດສິ່ງນີ້, ທ່ານເຮັດການຮ້ອງຂໍ `GET` ໄປຫາ endpoint `/v3/documents/{document_id}`.
ການຕອບສະໜອງຈາກ endpoint ນີ້ຈະປະກອບມີຊ່ອງຂໍ້ມູນ `status`, ເຊິ່ງຊີ້ບອກສະຖານະປະຈຸບັນຂອງວຽກ.
 ສະຖານະຈະປ່ຽນຈາກ `queued` ເປັນ `processing` ແລະສຸດທ້າຍເປັນ `done` ເມື່ອການແປສໍາເລັດ.
 ຂໍແນະນໍາໃຫ້ສອບຖາມ endpoint ນີ້ໃນໄລຍະເວລາທີ່ສົມເຫດສົມຜົນ, ເຊັ່ນ: ທຸກໆ 10-15 ວິນາທີ, ຈົນກ່ວາສະຖານະແມ່ນ `done` ຫຼື `error`.
ຂັ້ນຕອນທີ 5: ການດາວໂຫລດເອກະສານທີ່ແປແລ້ວ
ເມື່ອການກວດສອບສະຖານະສົ່ງຄືນ `done`, ເອກະສານປອກຕຸຍການທີ່ແປແລ້ວແມ່ນພ້ອມໃຫ້ດາວໂຫລດ.
 ທ່ານສາມາດດຶງເອົາໄຟລ໌ໄດ້ໂດຍການເຮັດການຮ້ອງຂໍ `GET` ສຸດທ້າຍໄປຫາ endpoint `/v3/documents/{document_id}/result`.
 endpoint ນີ້ສົ່ງຄືນຂໍ້ມູນ binary ຂອງໄຟລ໌ທີ່ແປແລ້ວ, ບໍ່ແມ່ນວັດຖຸ JSON.
ລະຫັດຂອງທ່ານຄວນເອົາເນື້ອຫາການຕອບສະໜອງ binary ນີ້ແລະຂຽນມັນໃສ່ໄຟລ໌ໃໝ່ໃນລະບົບທ້ອງຖິ່ນຂອງທ່ານ.
 ຕົວຢ່າງ, ທ່ານສາມາດບັນທຶກມັນເປັນ `translated_document.docx` ຖ້າຕົ້ນສະບັບເປັນເອກະສານ Word.
 ໄຟລ໌ສຸດທ້າຍນີ້ປະກອບດ້ວຍການແປທີ່ສົມບູນພ້ອມດ້ວຍການຈັດຮູບແບບແລະຮູບແບບການຈັດວາງເດີມທີ່ຖືກຮັກສາໄວ້, ພ້ອມສໍາລັບການນໍາໃຊ້ທັນທີ.
ຂໍ້ຄວນພິຈາລະນາຫຼັກສໍາລັບການແປພາສາປອກຕຸຍການ
ການແປຈາກພາສາອັງກິດເປັນພາສາປອກຕຸຍການກ່ຽວຂ້ອງກັບຫຼາຍກວ່າການພຽງແຕ່ປ່ຽນຄໍາສັບ; ມັນຮຽກຮ້ອງໃຫ້ມີຄວາມເຂົ້າໃຈກ່ຽວກັບຄວາມແຕກຕ່າງທາງດ້ານພາສາສາດແລະວັດທະນະທໍາ.
 ການແປທີ່ມີຄຸນນະພາບສູງຕ້ອງຄໍານຶງເຖິງຄວາມແຕກຕ່າງຂອງພາສາຖິ່ນ, ລະດັບຄວາມເປັນທາງການທີ່ເໝາະສົມ, ແລະການຈັດການຕົວອັກສອນພິເສດຢ່າງຖືກຕ້ອງ.
 The Doctranslate API ສະໜອງຄຸນສົມບັດທີ່ມີປະສິດທິພາບເພື່ອຊ່ວຍໃຫ້ທ່ານຈັດການກັບຄວາມລະອຽດອ່ອນເຫຼົ່ານີ້ ແລະຜະລິດການແປທີ່ສອດຄ່ອງກັບຜູ້ຊົມເປົ້າໝາຍຂອງທ່ານ.
ການເລືອກພາສາຖິ່ນທີ່ຖືກຕ້ອງ: ປອກຕຸຍການແບບເອີຣົບ ທຽບກັບ ປອກຕຸຍການແບບບຣາຊິນ
ພາສາປອກຕຸຍການມີສອງພາສາຖິ່ນຕົ້ນຕໍຄື: ປອກຕຸຍການແບບເອີຣົບ (ເວົ້າໃນປອກຕຸຍການ) ແລະ ປອກຕຸຍການແບບບຣາຊິນ (ເວົ້າໃນບຣາຊິນ).
 ໃນຂະນະທີ່ສາມາດເຂົ້າໃຈກັນໄດ້, ມີຄວາມແຕກຕ່າງທີ່ໜ້າສັງເກດໃນຄໍາສັບ, ການສະກົດຄໍາ, ແລະໄວຍາກອນລະຫວ່າງພວກມັນ.
 ຕົວຢ່າງ, ຄໍາສັບສໍາລັບ “bus” ແມ່ນ `autocarro` ໃນປອກຕຸຍການ ແຕ່ `ônibus` ໃນບຣາຊິນ, ແລະການນໍາໃຊ້ຄໍາສັບແທນນາມກໍ່ແຕກຕ່າງກັນຢ່າງຫຼວງຫຼາຍ.
ເມື່ອນໍາໃຊ້ API, ການກໍານົດພາສາເປົ້າໝາຍເປັນ `pt` ໃຫ້ການແປທີ່ເປັນມາດຕະຖານ, ຄຸນນະພາບສູງ ເຊິ່ງໂດຍທົ່ວໄປແລ້ວຜູ້ເວົ້າພາສາຖິ່ນທັງສອງເຂົ້າໃຈໄດ້ດີ.
 ແນວໃດກໍ່ຕາມ, ມັນເປັນສິ່ງຈໍາເປັນສໍາລັບທ່ານທີ່ຈະຮູ້ຈັກຜູ້ຊົມເປົ້າໝາຍຂອງທ່ານ.
 ຖ້າເນື້ອຫາຂອງທ່ານແມ່ນສະເພາະສໍາລັບບຣາຊິນ, ເຊິ່ງເປັນຕະຫຼາດທີ່ເວົ້າພາສາປອກຕຸຍການທີ່ໃຫຍ່ທີ່ສຸດ, ທ່ານອາດຈະຕ້ອງການທົບທວນຄືນຜົນຜະລິດເພື່ອຮັບປະກັນວ່າມັນສອດຄ່ອງກັບຄໍາສັບແລະຄໍາສັບທ້ອງຖິ່ນເພື່ອໃຫ້ມີຜົນກະທົບສູງສຸດ.
ການກໍານົດລະດັບຄວາມເປັນທາງການທີ່ຖືກຕ້ອງ
ພາສາປອກຕຸຍການມີຄວາມແຕກຕ່າງທີ່ຊັດເຈນລະຫວ່າງຮູບແບບການປາກເວົ້າແບບເປັນທາງການແລະບໍ່ເປັນທາງການ, ເຊິ່ງສາມາດສົ່ງຜົນກະທົບຢ່າງຫຼວງຫຼາຍຕໍ່ສຽງຂອງເນື້ອຫາຂອງທ່ານ.
 The Doctranslate API ປະກອບມີພາຣາມິດເຕີ `formality` ທີ່ມີຄຸນຄ່າທີ່ທ່ານສາມາດກໍານົດເປັນ `formal` ຫຼື `informal`.
 ຄຸນສົມບັດນີ້ປັບການແປຢ່າງສະຫຼາດເພື່ອໃຊ້ຄໍາສັບແທນນາມ, ການຜັນຄໍາກໍາມະ, ແລະຄໍາສັບທີ່ເໝາະສົມສໍາລັບບໍລິບົດທີ່ທ່ານຕ້ອງການ.
ຕົວຢ່າງ, ເມື່ອແປຄູ່ມືເຕັກນິກ, ເອກະສານທາງກົດໝາຍ, ຫຼືການສື່ສານທຸລະກິດຢ່າງເປັນທາງການ, ການຕັ້ງ `formality` ເປັນ `formal` ແມ່ນສໍາຄັນ.
 ນີ້ຮັບປະກັນວ່າການແປໃຊ້ສຽງທີ່ເຄົາລົບ ແລະເປັນມືອາຊີບ.
 ໃນທາງກັບກັນ, ສໍາລັບເອກະສານການຕະຫຼາດ, ໂພສ blog, ຫຼືສື່ສັງຄົມ, `informal` ອາດຈະເໝາະສົມກວ່າເພື່ອສ້າງສຽງທີ່ເປັນມິດ ແລະໜ້າສົນໃຈ.
ການຮັບປະກັນການຈັດການ Diacritics ແລະຕົວອັກສອນພິເສດຢ່າງຖືກຕ້ອງ
ການສະແດງ diacritics ຢ່າງຖືກຕ້ອງແມ່ນຄວາມຕ້ອງການທີ່ບໍ່ສາມາດຕໍ່ລອງໄດ້ສໍາລັບການແປພາສາປອກຕຸຍການລະດັບມືອາຊີບ.
 ພາສາແມ່ນອາໄສຕົວອັກສອນທີ່ມີເຄື່ອງໝາຍສຽງໜັກ, ເຊັ່ນ: `á`, `ê`, `í`, `õ`, ແລະ cedilla ໃນ `ç`.
 ການຈັດການຕົວອັກສອນເຫຼົ່ານີ້ບໍ່ຖືກຕ້ອງສົ່ງຜົນໃຫ້ຂໍ້ຄວາມເສຍຫາຍທີ່ເບິ່ງບໍ່ເປັນມືອາຊີບ ແລະສາມາດອ່ານຍາກ.
The Doctranslate API ຖືກສ້າງຂຶ້ນດ້ວຍການຮອງຮັບ UTF-8 ເຕັມຮູບແບບຕະຫຼອດຂະບວນການທັງໝົດ, ຕັ້ງແຕ່ການວິເຄາະໄຟລ໌ຕົ້ນສະບັບຈົນເຖິງການສ້າງເອກະສານທີ່ແປແລ້ວສຸດທ້າຍ.
 ນີ້ຮັບປະກັນວ່າຕົວອັກສອນພິເສດທັງໝົດຖືກຮັກສາໄວ້ດ້ວຍຄວາມຖືກຕ້ອງສົມບູນ.
 ທ່ານສາມາດໝັ້ນໃຈໄດ້ວ່າຜົນຜະລິດຈະສະອາດ, ຖືກຕ້ອງ, ແລະພ້ອມສໍາລັບຜູ້ຊົມທີ່ເວົ້າພາສາປອກຕຸຍການໂດຍບໍ່ມີບັນຫາທີ່ກ່ຽວຂ້ອງກັບການເຂົ້າລະຫັດ.
ບົດສະຫຼຸບ: ປັບປຸງໂຄງການເຮັດວຽກການແປຂອງທ່ານ
ການແປເອກະສານຈາກພາສາອັງກິດເປັນພາສາປອກຕຸຍການຢ່າງມີປະສິດທິພາບຮຽກຮ້ອງໃຫ້ມີການເອົາຊະນະອຸປະສັກທາງດ້ານເຕັກນິກທີ່ສໍາຄັນທີ່ກ່ຽວຂ້ອງກັບຮູບແບບໄຟລ໌, ການຮັກສາຮູບແບບ, ແລະຄວາມແຕກຕ່າງທາງດ້ານພາສາສາດ.
 The Doctranslate API ສະໜອງວິທີແກ້ໄຂທີ່ຄົບຖ້ວນ ແລະ ສະຫງ່າງາມ, ເສີມສ້າງຄວາມສາມາດໃຫ້ນັກພັດທະນາເພື່ອເຮັດໃຫ້ຂະບວນການທັງໝົດນີ້ເປັນແບບອັດຕະໂນມັດໄດ້ຢ່າງງ່າຍດາຍ.
 ໂດຍການປິດບັງຄວາມສັບສົນ, API ຂອງພວກເຮົາຊ່ວຍໃຫ້ທ່ານສາມາດສ້າງໂຄງການເຮັດວຽກການແປທີ່ມີປະສິດທິພາບ, ສາມາດປັບຂະໜາດໄດ້, ແລະເຊື່ອຖືໄດ້ໂດຍກົງໃນແອັບພລິເຄຊັນຂອງທ່ານ.
ຕັ້ງແຕ່ການຮັກສາຄວາມສົມບູນທາງດ້ານສາຍຕາຂອງເອກະສານທີ່ສັບສົນ ຈົນເຖິງການໃຫ້ການຄວບຄຸມສຽງທີ່ລະອຽດດ້ວຍການຕັ້ງຄ່າຄວາມເປັນທາງການ, ແພລດຟອມຂອງພວກເຮົາຖືກອອກແບບມາສໍາລັບຜົນໄດ້ຮັບທີ່ມີຄຸນນະພາບສູງ.
 ການເຊື່ອມໂຍງຄວາມສາມາດນີ້ບໍ່ພຽງແຕ່ປະຢັດເວລາແລະຊັບພະຍາກອນອັນມະຫາສານເມື່ອທຽບກັບການແປດ້ວຍຕົນເອງ, ແຕ່ຍັງຮັບປະກັນສຽງຍີ່ຫໍ້ທີ່ສອດຄ່ອງແລະເປັນມືອາຊີບໃນທົ່ວເນື້ອຫາທົ່ວໂລກຂອງທ່ານ.
 ທ່ານສາມາດສົ່ງມອບປະສົບການທີ່ປັບເຂົ້າກັບທ້ອງຖິ່ນໄດ້ໄວຂຶ້ນ ແລະມີປະສິດທິພາບຫຼາຍຂຶ້ນກວ່າແຕ່ກ່ອນ. ສໍາລັບການລົງເລິກຕື່ມອີກກ່ຽວກັບພາຣາມິດເຕີທີ່ມີຢູ່ທັງໝົດ ແລະຄຸນສົມບັດຂັ້ນສູງ, ພວກເຮົາຂໍແນະນໍາໃຫ້ທ່ານປຶກສາ ເອກະສານ API ຢ່າງເປັນທາງການຂອງພວກເຮົາ.