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

ສິ່ງກີດຂວາງທາງດ້ານເຕັກນິກຂອງການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາປອກຕຸຍກັນ

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

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

ການຈັດການກັບຄວາມສັບສົນຂອງການເຂົ້າລະຫັດຕົວອັກສອນ

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

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

ການຮັກສາຮູບແບບ ແລະ ການຈັດຮູບແບບທີ່ສັບສົນ

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

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

ການຈັດການໂຄງສ້າງໄຟລ໌ທີ່ຫຼາກຫຼາຍ

ແອັບພລິເຄຊັນຂອງທ່ານອາດຈະຕ້ອງການຮອງຮັບປະເພດໄຟລ໌ທີ່ຫຼາກຫຼາຍ, ຕັ້ງແຕ່ໄຟລ໌ .txt ງ່າຍໆໄປຈົນເຖິງ PDFs ທີ່ສັບສົນ ແລະ ເອກະສານ Microsoft Office.
ແຕ່ລະຮູບແບບມີໂຄງສ້າງພາຍໃນທີ່ເປັນເອກະລັກທີ່ຕ້ອງການຕົວວິເຄາະສະເພາະ.
ການສ້າງ ແລະ ຮັກສາຕົວວິເຄາະສໍາລັບ DOCX, PPTX, XLSX, ແລະ PDF ແມ່ນວຽກງານອັນໃຫຍ່ຫຼວງທີ່ເຮັດໃຫ້ເສຍສະມາທິຈາກເປົ້າໝາຍການພັດທະນາຫຼັກຂອງທ່ານ.
ນີ້ແມ່ນບ່ອນທີ່ API ການແປພາສາສະເພາະໃຫ້ຄຸນຄ່າອັນມະຫາສານ.

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

ການນໍາສະເໜີ Doctranslate REST API ສໍາລັບການເຊື່ອມໂຍງທີ່ບໍ່ມີຂໍ້ບົກພ່ອງ

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

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

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

ຄູ່ມືເທື່ອລະຂັ້ນຕອນເພື່ອເຊື່ອມໂຍງ API ການແປເອກະສານ

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

ຂໍ້ກໍານົດເບື້ອງຕົ້ນ: ລະຫັດ API ຂອງທ່ານ ແລະ ການກະກຽມໄຟລ໌

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

ຕໍ່ໄປ, ກະກຽມເອກະສານທີ່ທ່ານຕ້ອງການແປ.
API ຂອງພວກເຮົາຮອງຮັບຮູບແບບທີ່ຫຼາກຫຼາຍ, ລວມທັງ .pdf, .docx, .pptx, .xlsx, ແລະອື່ນໆ.
ສໍາລັບຕົວຢ່າງນີ້, ພວກເຮົາຈະສົມມຸດວ່າທ່ານມີໄຟລ໌ຊື່ `report_english.docx` ພ້ອມສໍາລັບການແປ.
ບໍ່ຈໍາເປັນຕ້ອງມີການກະກຽມພິເສດໃດໆຂອງໄຟລ໌;
API ຖືກອອກແບບມາເພື່ອຈັດການເອກະສານມາດຕະຖານຕາມທີ່ພວກມັນເປັນ.

ຂັ້ນຕອນທີ 1: ການອັບໂຫລດເອກະສານຂອງທ່ານສໍາລັບການແປ

ຂັ້ນຕອນທໍາອິດແມ່ນການອັບໂຫລດເອກະສານຕົ້ນສະບັບຂອງທ່ານໄປຫາ Doctranslate API.
ທ່ານຈະສ້າງຄໍາຮ້ອງຂໍ POST ໄປຫາຈຸດເຊື່ອມຕໍ່ `/v3/documents`.
ຄໍາຮ້ອງຂໍນີ້ຄວນຈະເປັນຄໍາຮ້ອງຂໍ multipart/form-data ທີ່ປະກອບດ້ວຍໄຟລ໌ນັ້ນເອງ, ພາສາຕົ້ນສະບັບ (`en`), ແລະ ພາສາເປົ້າໝາຍ (`pt-BR` ສໍາລັບ ປອກຕຸຍກັນບຣາຊິລ ຫຼື `pt` ສໍາລັບ ປອກຕຸຍກັນເອີຣົບ).
ຄໍາຮ້ອງຂໍທີ່ສໍາເລັດຈະສົ່ງຄືນວັດຖຸ JSON ທີ່ມີ `id` ທີ່ເປັນເອກະລັກສໍາລັບເອກະສານຂອງທ່ານ.

ນີ້ແມ່ນຕົວຢ່າງລະຫັດ Python ທີ່ສະແດງໃຫ້ເຫັນວິທີການອັບໂຫລດເອກະສານຂອງທ່ານ.
ຕົວຢ່າງນີ້ໃຊ້ຫ້ອງສະໝຸດ `requests` ທີ່ນິຍົມເພື່ອຈັດການຄໍາຮ້ອງຂໍ HTTP.
ຈື່ຈໍາທີ່ຈະປ່ຽນແທນ `’YOUR_API_KEY’` ດ້ວຍລະຫັດຕົວຈິງຂອງທ່ານ ແລະ ສະຫນອງເສັ້ນທາງທີ່ຖືກຕ້ອງໄປຫາໄຟລ໌ຂອງທ່ານ.
ການຕອບສະໜອງປະກອບດ້ວຍ `id` ທີ່ທ່ານຈະຕ້ອງການສໍາລັບຂັ້ນຕອນຕໍ່ໄປ.

import requests
import json

# Your API key and file details
api_key = 'YOUR_API_KEY'
file_path = 'report_english.docx'
source_lang = 'en'
target_lang = 'pt-BR'

# API endpoint for document upload
url = 'https://developer.doctranslate.io/v3/documents'

headers = {
    'Authorization': f'Bearer {api_key}'
}

files = {
    'file': (file_path, open(file_path, 'rb')),
    'source_lang': (None, source_lang),
    'target_lang': (None, target_lang),
}

# Make the POST request to upload the document
response = requests.post(url, headers=headers, files=files)

if response.status_code == 200:
    result = response.json()
    document_id = result.get('id')
    print(f'Successfully uploaded document. ID: {document_id}')
else:
    print(f'Error uploading document: {response.status_code} {response.text}')

ຂັ້ນຕອນທີ 2: ການກວດສອບສະຖານະການແປ
ເນື່ອງຈາກການແປເອກະສານອາດຈະໃຊ້ເວລາ, ຂະບວນການແມ່ນແບບ asynchronous.
 ຫຼັງຈາກການອັບໂຫລດ, ທ່ານຈໍາເປັນຕ້ອງກວດສອບສະຖານະຂອງວຽກງານການແປເປັນໄລຍະ.
 ທ່ານສາມາດເຮັດໄດ້ໂດຍການສ້າງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດເຊື່ອມຕໍ່ `/v3/documents/{id}/status`,
 ປ່ຽນແທນ `{id}` ດ້ວຍ ID ເອກະສານທີ່ທ່ານໄດ້ຮັບໃນຂັ້ນຕອນກ່ອນໜ້ານີ້.
 ການຕອບສະໜອງຈະສະແດງສະຖານະປັດຈຸບັນ, ເຊັ່ນ: `queued`, `processing`, ຫຼື `completed`.
ທ່ານຄວນປະຕິບັດກົນໄກການສຳຫຼວດໃນລະຫັດຂອງທ່ານເພື່ອເພື່ອກວດສອບສະຖານະທຸກໆສອງສາມວິນາທີ.
 ເມື່ອສະຖານະປ່ຽນເປັນ `completed`, ທ່ານສາມາດດໍາເນີນການຂັ້ນຕອນສຸດທ້າຍຂອງການດາວໂຫຼດໄຟລ໌.
 ໃຫ້ແນ່ໃຈວ່າຈະລວມເອົາການຈັດການຂໍ້ຜິດພາດສໍາລັບສະຖານະ `error` ທີ່ອາດຈະເກີດຂຶ້ນ,
 ເຊິ່ງຈະຊີ້ບອກເຖິງບັນຫາໃນລະຫວ່າງຂະບວນການແປ.
 ນີ້ຮັບປະກັນວ່າແອັບພລິເຄຊັນຂອງທ່ານສາມາດຕອບສະໜອງໄດ້ຢ່າງເໝາະສົມຕໍ່ກັບຜົນໄດ້ຮັບທີ່ແຕກຕ່າງກັນ.
import time

# This function checks the status of the translation
def check_status(document_id, api_key):
    status_url = f'https://developer.doctranslate.io/v3/documents/{document_id}/status'
    headers = {
        'Authorization': f'Bearer {api_key}'
    }

    while True:
        response = requests.get(status_url, headers=headers)
        if response.status_code == 200:
            status_data = response.json()
            current_status = status_data.get('status')
            print(f'Current status: {current_status}')

            if current_status == 'completed':
                print('Translation finished successfully!')
                return True
            elif current_status == 'error':
                print('An error occurred during translation.')
                return False

            # Wait for 10 seconds before checking again
            time.sleep(10)
        else:
            print(f'Error checking status: {response.status_code} {response.text}')
            return False

# Assuming you have the document_id from the upload step
# check_status(document_id, api_key)

ຂັ້ນຕອນທີ 3: ການດາວໂຫຼດເອກະສານທີ່ແປແລ້ວ
ຂັ້ນຕອນສຸດທ້າຍແມ່ນການດາວໂຫຼດເອກະສານທີ່ແປແລ້ວຂອງທ່ານ.
 ເມື່ອສະຖານະເປັນ `completed`, ທ່ານສ້າງຄໍາຮ້ອງຂໍ GET ໄປຫາຈຸດເຊື່ອມຕໍ່ `/v3/documents/{id}/download`.
 ຈຸດເຊື່ອມຕໍ່ນີ້ຈະຕອບສະໜອງດ້ວຍຂໍ້ມູນ binary ຂອງໄຟລ໌ທີ່ແປແລ້ວ,
 ເຊິ່ງທ່ານສາມາດບັນທຶກໄວ້ໃນເຄື່ອງໄດ້.
 ໄຟລ໌ຈະຮັກສາຊື່ ແລະ ຮູບແບບຕົ້ນສະບັບຂອງມັນ, ແຕ່ມີເນື້ອຫາຂອງມັນຖືກແປເປັນ ພາສາປອກຕຸຍກັນ ຢ່າງສົມບູນ.
ມັນເປັນສິ່ງສໍາຄັນທີ່ຈະຈັດການການຕອບສະໜອງເປັນສາຍຂອງ bytes ແລະ ຂຽນມັນໂດຍກົງໃສ່ໄຟລ໌.
 ນີ້ຮັບປະກັນວ່າໄຟລ໌ຖືກບັນທຶກຢ່າງຖືກຕ້ອງໂດຍບໍ່ມີບັນຫາການເຂົ້າລະຫັດຕົວອັກສອນໃດໆ.
 ລະຫັດ Python ຕໍ່ໄປນີ້ສະແດງໃຫ້ເຫັນວິທີການດາວໂຫຼດໄຟລ໌ແລະບັນທຶກມັນເປັນ `report_portuguese.docx`.
 ດ້ວຍຂັ້ນຕອນນີ້, ທ່ານໄດ້ສໍາເລັດຂະບວນການເຮັດວຽກການແປເອກະສານແບບຕົ້ນຈົນຈົບຢ່າງສໍາເລັດຜົນ.
# This function downloads the translated file
def download_translated_file(document_id, api_key, output_path):
    download_url = f'https://developer.doctranslate.io/v3/documents/{document_id}/download'
    headers = {
        'Authorization': f'Bearer {api_key}'
    }

    response = requests.get(download_url, headers=headers, stream=True)

    if response.status_code == 200:
        with open(output_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f'Translated file saved to {output_path}')
    else:
        print(f'Error downloading file: {response.status_code} {response.text}')

# Example usage after status is 'completed'
# output_file_path = 'report_portuguese.docx'
# if check_status(document_id, api_key):
#     download_translated_file(document_id, api_key, output_file_path)

ການພິຈາລະນາທີ່ສໍາຄັນສໍາລັບການແປ ພາສາອັງກິດ ເປັນ ພາສາປອກຕຸຍກັນ
ການແປຈາກ ພາສາອັງກິດ ເປັນ ພາສາປອກຕຸຍກັນ ກ່ຽວຂ້ອງກັບຫຼາຍກວ່າການປ່ຽນຄໍາສັບຕ່າງໆ.
 ພາສາດັ່ງກ່າວມີກົດລະບຽບໄວຍາກອນສະເພາະ ແລະ ຄວາມແຕກຕ່າງທາງດ້ານວັດທະນະທໍາທີ່ຕ້ອງໄດ້ຮັບການຈັດການຢ່າງຖືກຕ້ອງສໍາລັບການແປທີ່ມີຄຸນນະພາບສູງ.
 ເຄື່ອງຈັກການແປພື້ນຖານຂອງ API ຂອງພວກເຮົາໄດ້ຮັບການຝຶກອົບຮົມກ່ຽວກັບຊຸດຂໍ້ມູນຈໍານວນຫຼວງຫຼາຍເພື່ອເຂົ້າໃຈແລະນໍາໃຊ້ກົດລະບຽບເຫຼົ່ານີ້,
 ແຕ່ໃນຖານະເປັນນັກພັດທະນາ, ການຮັບຮູ້ກ່ຽວກັບພວກມັນຊ່ວຍໃນການສົ່ງມອບຜະລິດຕະພັນສຸດທ້າຍທີ່ດີກວ່າໃຫ້ກັບຜູ້ໃຊ້ຂອງທ່ານ.
ການຈັດການເຄື່ອງໝາຍເນັ້ນສຽງ ແລະ ການເຂົ້າລະຫັດ UTF-8
ດັ່ງທີ່ໄດ້ກ່າວມາຂ້າງເທິງ, ພາສາປອກຕຸຍກັນໃຊ້ຕົວອັກສອນພິເສດຫຼາຍອັນທີ່ບໍ່ມີຢູ່ໃນຕົວອັກສອນ ພາສາອັງກິດ.
 ການຮັບປະກັນວ່າ stack ແອັບພລິເຄຊັນທັງໝົດຂອງທ່ານ, ຕັ້ງແຕ່ຖານຂໍ້ມູນຈົນເຖິງ frontend, ຈັດການ UTF-8 ຢ່າງຖືກຕ້ອງແມ່ນສໍາຄັນ.
 ເມື່ອທ່ານໄດ້ຮັບຂໍ້ມູນຈາກ API, ທ່ານກໍາລັງໄດ້ຮັບໄຟລ໌ທີ່ມີຂໍ້ຄວາມ ພາສາປອກຕຸຍກັນ ທີ່ຖືກເຂົ້າລະຫັດຢ່າງຖືກຕ້ອງ;
 ມັນເປັນສິ່ງຈໍາເປັນທີ່ຈະຮັກສາການເຂົ້າລະຫັດນັ້ນເພື່ອຫຼີກເວັ້ນບັນຫາການສະແດງຜົນສໍາລັບຜູ້ໃຊ້ສຸດທ້າຍຂອງທ່ານ.
 API ຂອງພວກເຮົາຮັບປະກັນການເຂົ້າລະຫັດທີ່ຖືກຕ້ອງໃນໄຟລ໌ຜົນໄດ້ຮັບ, ເຮັດໃຫ້ການເຊື່ອມໂຍງຂອງທ່ານງ່າຍຂຶ້ນ.
ການຈັດການຄວາມເປັນທາງການ ແລະ ສໍານຽງພາກພື້ນ
ພາສາປອກຕຸຍກັນມີສອງຮູບແບບຫຼັກຄື: ປອກຕຸຍກັນບຣາຊິລ (pt-BR) ແລະ ປອກຕຸຍກັນເອີຣົບ (pt-PT).
 ໃນຂະນະທີ່ພວກມັນສາມາດເຂົ້າໃຈເຊິ່ງກັນແລະກັນໄດ້, ພວກມັນມີຄວາມແຕກຕ່າງໃນຄໍາສັບ, ໄວຍາກອນ, ແລະ ຄວາມເປັນທາງການ.
 The Doctranslate API ຊ່ວຍໃຫ້ທ່ານສາມາດກໍານົດສໍານຽງເປົ້າໝາຍໂດຍໃຊ້ຕົວກໍານົດ `target_lang`, ຮັບປະກັນການແປທີ່ເປັນທ້ອງຖິ່ນແລະເໝາະສົມກວ່າ.
 ການໃຊ້ `pt-BR` ໂດຍທົ່ວໄປແມ່ນແນະນໍາໃຫ້ສໍາລັບຜູ້ຊົມທີ່ກວ້າງຂວາງກວ່າ, ເນື່ອງຈາກປະເທດບຣາຊິນມີປະຊາກອນຜູ້ເວົ້າ ພາສາປອກຕຸຍກັນ ຫຼາຍກວ່າ.
ຄວາມເປັນທາງການກໍ່ແມ່ນລັກສະນະສໍາຄັນຂອງພາສາ.
 ການເລືອກລະຫວ່າງ `você` (ທົ່ວໄປກວ່າ ແລະ ສາມາດເປັນທາງການ ຫຼື ບໍ່ເປັນທາງການ) ແລະ `tu` (ບໍ່ເປັນທາງການຢ່າງເຂັ້ມງວດໃນປະເທດບຣາຊິນສ່ວນໃຫຍ່) ສາມາດປ່ຽນສຽງຂອງຂໍ້ຄວາມໄດ້ຢ່າງຫຼວງຫຼາຍ.
 ຮູບແບບການແປທີ່ຂັບເຄື່ອນດ້ວຍ AI ຂອງພວກເຮົາແມ່ນເກັ່ງໃນການຈັບເອົາບໍລິບົດຈາກຂໍ້ຄວາມ ພາສາອັງກິດ ຕົ້ນສະບັບ ເພື່ອເລືອກລະດັບຄວາມເປັນທາງການທີ່ເໝາະສົມ.
 ສໍາລັບແອັບພລິເຄຊັນໃນຂະແໜງທຸລະກິດ ຫຼື ກົດໝາຍ, ນີ້ ການແປທີ່ຮັບຮູ້ບໍລິບົດ ແມ່ນມີຄ່າຢ່າງຍິ່ງສໍາລັບການຮັກສາມືອາຊີບ.
ການຮັບປະກັນຄວາມຖືກຕ້ອງຂອງໄວຍາກອນ: ການສອດຄ່ອງເພດ ແລະ ຈໍານວນ
ແຕກຕ່າງຈາກ ພາສາອັງກິດ, ພາສາປອກຕຸຍກັນເປັນພາສາທີ່ມີເພດ ບ່ອນທີ່ຄໍານາມເປັນເພດຊາຍ ຫຼື ເພດຍິງ.
 ຄໍາຄຸນນາມ ແລະ ຄໍາປະກອບຕ້ອງສອດຄ່ອງກັບເພດ ແລະ ຈໍານວນກັບຄໍານາມທີ່ພວກມັນດັດແປງ.
 ນີ້ເພີ່ມຊັ້ນຄວາມສັບສົນທີ່ລະບົບການແປພາສາດ້ວຍເຄື່ອງຈັກຕ້ອງຈັດການຢ່າງຖືກຕ້ອງ.
 ຕົວຢ່າງ, ‘a big house’ ກາຍເປັນ ‘uma casa grande’ (ເພດຍິງ), ໃນຂະນະທີ່ ‘a big car’ ກາຍເປັນ ‘um carro grande’ (ເພດຊາຍ).
ເຄື່ອງຈັກ Doctranslate ໄດ້ຖືກຝຶກອົບຮົມສະເພາະເພື່ອຈັດການຄວາມສອດຄ່ອງທາງດ້ານໄວຍາກອນເຫຼົ່ານີ້.
 ມັນວິເຄາະໂຄງສ້າງປະໂຫຍກເພື່ອຮັບປະກັນວ່າຜົນໄດ້ຮັບທີ່ແປບໍ່ພຽງແຕ່ຖືກຕ້ອງໃນຄວາມຫມາຍເທົ່ານັ້ນ ແຕ່ຍັງຖືກຕ້ອງຕາມໄວຍາກອນ.
 ຄວາມສາມາດຂັ້ນສູງນີ້ຊ່ວຍໃຫ້ທ່ານຫຼີກລ້ຽງຄວາມຈໍາເປັນໃນການແກ້ໄຂຫຼັງການແປທີ່ກວ້າງຂວາງ ແລະ ຮັບປະກັນວ່າເອກະສານສຸດທ້າຍສາມາດອ່ານໄດ້ຢ່າງເປັນທໍາມະຊາດສໍາລັບຜູ້ເວົ້າພື້ນເມືອງ.
 ສຶກສາວິທີການເຮັດວຽກຂອງເຕັກໂນໂລຢີຂອງພວກເຮົາເພື່ອ ສະໜອງການແປເອກະສານຂອງທ່ານຢ່າງວ່ອງໄວແລະຖືກຕ້ອງ ໃນຂະນະທີ່ຮັກສາການຈັດຮູບແບບຕົ້ນສະບັບ.
ສະຫຼຸບ: ປັບປຸງຂະບວນການເຮັດວຽກການແປຂອງທ່ານໃຫ້ຄ່ອງຕົວໃນມື້ນີ້
ການເຊື່ອມໂຍງ API ການແປເອກະສານ ພາສາອັງກິດ ເປັນ ພາສາປອກຕຸຍກັນ ທີ່ແຂງແຮງ ແມ່ນວິທີທີ່ມີປະສິດທິພາບທີ່ສຸດໃນການສ້າງຄວາມສາມາດຫຼາຍພາສາເຂົ້າໃນແອັບພລິເຄຊັນຂອງທ່ານ.
 ມັນຊ່ວຍປະຢັດທ່ານຈາກຄວາມສັບສົນອັນໃຫຍ່ຫຼວງຂອງການວິເຄາະໄຟລ໌, ການຮັກສາຮູບແບບ, ແລະ ຄວາມແຕກຕ່າງທາງດ້ານພາສາ.
 The Doctranslate API ສະຫນອງຂະບວນການເຮັດວຽກທີ່ງ່າຍດາຍ, asynchronous ທີ່ອະນຸຍາດໃຫ້ນັກພັດທະນາສາມາດບັນລຸການແປເອກະສານທີ່ມີຄຸນນະພາບສູງ, ຖືກຕ້ອງ ດ້ວຍຄວາມພະຍາຍາມໜ້ອຍທີ່ສຸດ.
ໂດຍການປະຕິບັດຕາມຂັ້ນຕອນທີ່ໄດ້ກ່າວໄວ້ໃນຄູ່ມືນີ້, ທ່ານສາມາດຕັ້ງຄ່າທໍ່ສົ່ງການແປອັດຕະໂນມັດໄດ້ຢ່າງວ່ອງໄວ.
 ຕັ້ງແຕ່ການອັບໂຫຼດເອກະສານຕົ້ນສະບັບໄປຈົນເຖິງການດາວໂຫຼດເອກະສານ ພາສາປອກຕຸຍກັນ ທີ່ຖືກຈັດຮູບແບບຢ່າງສົມບູນ, REST API ຂອງພວກເຮົາສະໜອງເຄື່ອງມືທັງໝົດທີ່ທ່ານຕ້ອງການ.
 ພວກເຮົາຊຸກຍູ້ໃຫ້ທ່ານສຶກສາເອກະສານ API ຢ່າງເປັນທາງການຂອງພວກເຮົາສໍາລັບຂໍ້ມູນລາຍລະອຽດເພີ່ມເຕີມກ່ຽວກັບຮູບແບບທີ່ຮອງຮັບ, ທາງເລືອກຂັ້ນສູງ, ແລະ ຈຸດເຊື່ອມຕໍ່ເພີ່ມເຕີມ.
 ເລີ່ມສ້າງແອັບພລິເຄຊັນທີ່ລວມເອົາຫຼາຍຂຶ້ນ ແລະ ສາມາດເຂົ້າເຖິງໄດ້ທົ່ວໂລກໃນມື້ນີ້.