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

ຄວາມທ້າທາຍທີ່ແທ້ຈິງຂອງການແປ PDF ຜ່ານ API

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

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

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

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

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

ການຈັດການອົງປະກອບທີ່ຝັງຢູ່

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

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

ການສະກັດ ແລະ ການສ້າງຂໍ້ຄວາມຄືນໃໝ່

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

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

Doctranslate API: ວິທີແກ້ໄຂທີ່ເນັ້ນໃສ່ນັກພັດທະນາເປັນຫຼັກ

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

ໂດຍຫຼັກການແລ້ວ, API ໃຫ້ບໍລິການທີ່ແຂງແກ່ນເພື່ອແປ PDF ຈາກພາສາອັງກິດເປັນພາສາສະເປນ ໃນຂະນະທີ່ຮັບປະກັນຄວາມเที่ยงตรงสูง.
ຂະບວນການທັງໝົດເປັນແບບ asynchronous, ເຮັດໃຫ້ມັນເໝາະສົມກັບການຈັດການໄຟລ໌ຂະໜາດໃຫຍ່ ແລະ ການດຳເນີນການເປັນຊຸດໂດຍບໍ່ກີດຂວາງ thread ຫຼັກຂອງແອັບພລິເຄຊັນຂອງທ່ານ.
ທ່ານພຽງແຕ່ສົ່ງເອກະສານ, ແລະ API ຈະແຈ້ງເຕືອນທ່ານ ຫຼື ອະນຸຍາດໃຫ້ທ່ານສອບຖາມຜົນລັບ, ສົ່ງຄືນໄຟລ໌ທີ່ແປໄດ້ຢ່າງສົມບູນພ້ອມກັບຮູບແບບທີ່ຖືກຮັກສາໄວ້.

ຄຸນສົມບັດຫຼັກ ແລະ ຂໍ້ໄດ້ປຽບ

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

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

ການທຳຄວາມເຂົ້າໃຈຂັ້ນຕອນການເຮັດວຽກຂອງ API

ຂັ້ນຕອນການເຊື່ອມໂຍງຖືກອອກແບບມາໃຫ້ມີເຫດຜົນ ແລະ ເປັນມິດກັບນັກພັດທະນາ, ໂດຍປະຕິບັດຕາມສົນທິສັນຍາ REST API ມາດຕະຖານ.
ຂະບວນການເປັນແບບ asynchronous ເພື່ອຮອງຮັບເວລາທີ່ຕ້ອງການສຳລັບການປະມວນຜົນເອກະສານທີ່ຊັບຊ້ອນ.
ນີ້ແມ່ນລຳດັບການເອີ້ນ API ທົ່ວໄປສຳລັບການແປເອກະສານ:

• ການພິສູດຢືນຢັນ: ລວມເອົາລະຫັດ API ທີ່ເປັນເອກະລັກຂອງທ່ານໃນສ່ວນຫົວຂອງຄຳຮ້ອງຂໍເພື່ອການເຂົ້າເຖິງທີ່ປອດໄພ.
• ການອັບໂຫຼດເອກະສານ: ສົ່ງຄຳຮ້ອງຂໍ POST ພ້ອມກັບໄຟລ໌ PDF ຂອງທ່ານໄປທີ່ຈຸດເຊື່ອມຕໍ່ `/v3/translate/document`.
• ການເລີ່ມຕົ້ນວຽກ: API ຈະຮັບໄຟລ໌ ແລະ ສົ່ງຄືນ `id` ທີ່ເປັນເອກະລັກສຳລັບວຽກການແປ.
• ການກວດສອບສະຖານະ: ສົ່ງຄຳຮ້ອງຂໍ GET ເປັນໄລຍະໆໄປທີ່ຈຸດເຊື່ອມຕໍ່ສະຖານະໂດຍໃຊ້ `id` ຂອງວຽກເພື່ອເບິ່ງວ່າການແປສຳເລັດແລ້ວຫຼືບໍ່.
• ການດາວໂຫຼດຜົນລັບ: ເມື່ອສະຖານະຂອງວຽກເປັນ “done”, ການຕອບສະໜອງຈະມີ URL ທີ່ທ່ານສາມາດດາວໂຫຼດໄຟລ໌ PDF ທີ່ແປແລ້ວໄດ້.

ຄູ່ມືຂັ້ນຕອນຕໍ່ຂັ້ນຕອນ: ການເຊື່ອມໂຍງ API ການແປ PDF ຈາກພາສາອັງກິດເປັນພາສາສະເປນ

ພາກນີ້ໃຫ້ຄູ່ມືທີ່ເປັນພາກປະຕິບັດ, ຂັ້ນຕອນຕໍ່ຂັ້ນຕອນ ເພື່ອເຊື່ອມໂຍງ Doctranslate API ເຂົ້າກັບແອັບພລິເຄຊັນ Python.
ພວກເຮົາຈະກວມເອົາທຸກຢ່າງຕັ້ງແຕ່ການຕັ້ງຄ່າສະພາບແວດລ້ອມຂອງທ່ານຈົນເຖິງການອັບໂຫຼດເອກະສານ ແລະ ການດຶງເອົາສະບັບທີ່ແປແລ້ວສຸດທ້າຍ.
ຫຼັກການດຽວກັນນີ້ສາມາດນຳໄປໃຊ້ກັບພາສາການຂຽນໂປຣແກຣມອື່ນໆໄດ້ຢ່າງງ່າຍດາຍ ເຊັ່ນ Node.js, Ruby, ຫຼື Java ໂດຍໃຊ້ไลบรารี HTTP client ຂອງແຕ່ລະພາສາ.

ຂັ້ນຕອນທີ 1: ການຕັ້ງຄ່າສະພາບແວດລ້ອມ ແລະ ລະຫັດ API ຂອງທ່ານ

ກ່ອນທີ່ຈະເອີ້ນ API ໃດໆ, ທ່ານຈຳເປັນຕ້ອງຕິດຕັ້ງ Python ໃນລະບົບຂອງທ່ານພ້ອມກັບไลบรารี `requests`, ເຊິ່ງເຮັດໃຫ້ການສົ່ງຄຳຮ້ອງຂໍ HTTP ງ່າຍຂຶ້ນ.
ທ່ານສາມາດຕິດຕັ້ງມັນໄດ້ຢ່າງງ່າຍດາຍໂດຍໃຊ້ pip: `pip install requests`.
ທ່ານຍັງຈະຕ້ອງໄດ້ຮັບລະຫັດ API ຂອງທ່ານຈາກແຜງຄວບຄຸມນັກພັດທະນາຂອງ Doctranslate, ເຊິ່ງທ່ານຈະໃຊ້ເພື່ອພິສູດຢືນຢັນຄຳຮ້ອງຂໍຂອງທ່ານ.

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

ຂັ້ນຕອນທີ 2: ການອັບໂຫຼດ PDF ຂອງທ່ານເພື່ອການແປ

ຂັ້ນຕອນທຳອິດໃນຂະບວນການເຮັດວຽກແບບໂປຣແກຣມແມ່ນການອັບໂຫຼດ PDF ຕົ້ນສະບັບພາສາອັງກິດໄປທີ່ Doctranslate API.
ສິ່ງນີ້ເຮັດໄດ້ໂດຍການສົ່ງຄຳຮ້ອງຂໍ POST ແບບ `multipart/form-data` ໄປທີ່ຈຸດເຊື່ອມຕໍ່ `/v3/translate/document`.
ເນື້ອໃນຂອງຄຳຮ້ອງຂໍຕ້ອງລວມມີໄຟລ໌ເອງ, ພາສາຕົ້ນສະບັບ (`source_lang`), ແລະ ພາສາເປົ້າໝາຍ (`target_lang`).

ນີ້ແມ່ນຕົວຢ່າງໂຄດ Python ທີ່ສະແດງວິທີການສ້າງ ແລະ ສົ່ງຄຳຮ້ອງຂໍນີ້.
ໂຄດນີ້ເປີດໄຟລ໌ PDF ທ້ອງຖິ່ນ, ຕັ້ງຄ່າພາຣາມິເຕີທີ່ຈຳເປັນສຳລັບການແປຈາກພາສາອັງກິດເປັນພາສາສະເປນ, ແລະ ລວມເອົາລະຫັດ API ໃນສ່ວນຫົວ `Authorization`.
ຄຳຮ້ອງຂໍທີ່ສຳເລັດຈະສົ່ງຄືນວັດຖຸ JSON ທີ່ມີ `id` ສຳລັບວຽກການແປທີ່ສ້າງຂຶ້ນໃໝ່.

import os
import requests

# ເອົາລະຫັດ API ຂອງທ່ານຈາກຕົວແປສະພາບແວດລ້ອມ
API_KEY = os.getenv("DOCTRANSLATE_API_KEY")
API_URL = "https://developer.doctranslate.io/v3/translate/document"

# ເສັ້ນທາງໄປຫາໄຟລ໌ PDF ຕົ້ນສະບັບຂອງທ່ານ
file_path = "path/to/your/document_en.pdf"

headers = {
    "Authorization": f"Bearer {API_KEY}"
}

data = {
    "source_lang": "en",
    "target_lang": "es"
}

# ເປີດໄຟລ໌ໃນໂໝດອ່ານແບບໄບນາຣີ
with open(file_path, "rb") as file:
    files = {
        "file": (os.path.basename(file_path), file, "application/pdf")
    }

    print("ກຳລັງອັບໂຫຼດເອກະສານເພື່ອການແປ...")
    response = requests.post(API_URL, headers=headers, data=data, files=files)

if response.status_code == 200:
    job_data = response.json()
    job_id = job_data.get("id")
    print(f"ເລີ່ມວຽກການແປສຳເລັດແລ້ວດ້ວຍ ID: {job_id}")
else:
    print(f"ຂໍ້ຜິດພາດ: {response.status_code} - {response.text}")

ຂັ້ນຕອນທີ 3: ການສອບຖາມສະຖານະການແປ
ເນື່ອງຈາກຂະບວນການແປເປັນແບບ asynchronous, ທ່ານຈຳເປັນຕ້ອງກວດສອບສະຖານະຂອງວຽກເປັນໄລຍະໆ.
 ສິ່ງນີ້ເຮັດໄດ້ໂດຍການສົ່ງຄຳຮ້ອງຂໍ GET ໄປທີ່ຈຸດເຊື່ອມຕໍ່ສະຖານະ, ເຊິ່ງລວມມີ `id` ທີ່ທ່ານໄດ້ຮັບໃນຂັ້ນຕອນກ່ອນໜ້ານີ້.
 ສະຖານະຈະປ່ຽນຈາກສະຖານະເຊັ່ນ “processing” ໄປເປັນ “done” ເມື່ອການແປສຳເລັດ ຫຼື “error” ຖ້າມີບາງຢ່າງຜິດພາດ.
ທ່ານຄວນຈັດຕັ້ງກົນໄກການສອບຖາມທີ່ມີການໜ່ວງເວລາທີ່ສົມເຫດສົມຜົນ, ເຊັ່ນ ການກວດສອບທຸກໆ 5-10 ວິນາທີ, ເພື່ອຫຼີກລ້ຽງການເກີນຂີດຈຳກັດອັດຕາ.
 ຈຸດເຊື່ອມຕໍ່ສະຖານະຈະໃຫ້ການອັບເດດຄວາມຄືບໜ້າຂອງວຽກການແປຂອງທ່ານແບບສົດໆ.
 ເມື່ອສະຖານະເປັນ “done”, ການຕອບສະໜອງ JSON ກໍ່ຈະມີ URL ເພື່ອດາວໂຫຼດ PDF ພາສາສະເປນທີ່ສຳເລັດແລ້ວ.
import time

STATUS_URL = f"https://developer.doctranslate.io/v3/translate/document/{job_id}"

# ສົມມຸດວ່າ job_id ມີຢູ່ຈາກຂັ້ນຕອນກ່ອນໜ້ານີ້

while True:
    print("ກຳລັງກວດສອບສະຖານະການແປ...")
    status_response = requests.get(STATUS_URL, headers=headers)

    if status_response.status_code == 200:
        status_data = status_response.json()
        job_status = status_data.get("status")
        print(f"ສະຖານະວຽກປັດຈຸບັນ: {job_status}")

        if job_status == "done":
            download_url = status_data.get("translated_document_url")
            print(f"ການແປສຳເລັດ! ດາວໂຫຼດຈາກ: {download_url}")
            break
        elif job_status == "error":
            print(f"ເກີດຂໍ້ຜິດພາດ: {status_data.get('error_message')}")
            break
    else:
        print(f"ຂໍ້ຜິດພາດໃນການກວດສອບສະຖານະ: {status_response.status_code}")
        break

    # ລໍຖ້າ 10 ວິນາທີກ່ອນກວດສອບອີກຄັ້ງ
    time.sleep(10)

ຂັ້ນຕອນທີ 4: ການດາວໂຫຼດ PDF ພາສາສະເປນທີ່ແປແລ້ວ
ຂັ້ນຕອນສຸດທ້າຍແມ່ນການດາວໂຫຼດເອກະສານທີ່ແປແລ້ວຈາກ URL ທີ່ໃຫ້ໄວ້ໃນການຕອບສະໜອງສະຖານະ.
 ທ່ານສາມາດເຮັດສິ່ງນີ້ໄດ້ໂດຍການສົ່ງຄຳຮ້ອງຂໍ GET ງ່າຍໆໄປທີ່ URL ນັ້ນ ແລະ ບັນທຶກເນື້ອໃນການຕອບສະໜອງໃສ່ໄຟລ໌ທ້ອງຖິ່ນ.
 ມັນສຳຄັນທີ່ຈະເປີດໄຟລ໌ໃໝ່ໃນໂໝດຂຽນແບບໄບນາຣີ (`’wb’`) ເພື່ອບັນທຶກເນື້ອໃນ PDF ຢ່າງຖືກຕ້ອງ.
ຂະບວນການອັດຕະໂນມັດນີ້ຮັບປະກັນວ່າທ່ານຈະໄດ້ຮັບ PDF ພາສາສະເປນຄຸນນະພາບສູງໂດຍບໍ່ຕ້ອງມີການແຊກແຊງດ້ວຍມື. ເຄື່ອງມືທີ່ມີປະສິດທິພາບຂອງ Doctranslate ຮັບປະກັນວ່າທ່ານຈະຮັກສາຮູບແບບ, ຕາຕະລາງ, ສົ່ງມອບໄຟລ໌ທີ່ພ້ອມໃຊ້ງານທັນທີ. ການຮັກສາການຈັດຮູບແບບນີ້ເປັນຄຸນສົມບັດທີ່ສຳຄັນສຳລັບແອັບພລິເຄຊັນລະດັບມືອາຊີບໃດໆທີ່ຈັດການກັບເອກະສານທາງການ ຫຼື ເອກະສານທີ່ຊັບຊ້ອນ.
# ສົມມຸດວ່າ download_url ມີຢູ່ຈາກຂັ້ນຕອນກ່ອນໜ້ານີ້

if download_url:
    print("ກຳລັງດາວໂຫຼດເອກະສານທີ່ແປແລ້ວ...")
    translated_doc_response = requests.get(download_url)

    if translated_doc_response.status_code == 200:
        # ກໍານົດເສັ້ນທາງໄຟລ໌ຜົນໄດ້ຮັບ
        output_file_path = "path/to/your/document_es.pdf"
        with open(output_file_path, "wb") as f:
            f.write(translated_doc_response.content)
        print(f"ເອກະສານທີ່ແປແລ້ວຖືກບັນທຶກໄປທີ່ {output_file_path}")
    else:
        print(f"ການດາວໂຫຼດເອກະສານທີ່ແປແລ້ວລົ້ມເຫຼວ: {translated_doc_response.status_code}")

ຂໍ້ຄວນພິຈາລະນາທີ່ສຳຄັນສຳລັບການແປພາສາສະເປນ
ການແປເນື້ອຫາເປັນພາສາສະເປນກ່ຽວຂ້ອງກັບຫຼາຍກວ່າພຽງແຕ່ການປ່ຽນຄຳສັບ; ມັນຕ້ອງການຄວາມເຂົ້າໃຈໃນຄວາມແຕກຕ່າງທາງດ້ານພາສາ.
 ເມື່ອໃຊ້ API ເພື່ອແປ PDF ຈາກພາສາອັງກິດເປັນພາສາສະເປນ, ນັກພັດທະນາຄວນຮັບຮູ້ເຖິງປັດໄຈສຳຄັນຫຼາຍຢ່າງທີ່ສາມາດສົ່ງຜົນກະທົບຕໍ່ຄຸນນະພາບ ແລະ ຄວາມເໝາະສົມຂອງເອກະສານສຸດທ້າຍ.
 ຂໍ້ຄວນພິຈາລະນາເຫຼົ່ານີ້ຮັບປະກັນວ່າເນື້ອຫາທີ່ແປແລ້ວບໍ່ພຽງແຕ່ຖືກຕ້ອງເທົ່ານັ້ນ ແຕ່ຍັງມີຄວາມກ່ຽວຂ້ອງທາງດ້ານວັດທະນະທຳ ແລະ ບໍລິບົດສຳລັບກຸ່ມເປົ້າໝາຍອີກດ້ວຍ.
ລະດັບພາສາທາງການ ແລະ ບໍ່ເປັນທາງການ (‘tú’ ທຽບກັບ ‘usted’)
ພາສາສະເປນມີຄຳແທນນາມ ແລະ ການຜັນຄຳກິລິຍາທີ່ແຕກຕ່າງກັນສຳລັບການເວົ້າແບບທາງການ (‘usted’) ແລະ ບໍ່ເປັນທາງການ (‘tú’).
 ການໃຊ້ລະດັບພາສາທີ່ບໍ່ຖືກຕ້ອງສາມາດເຮັດໃຫ້ເອກະສານທຸລະກິດເບິ່ງບໍ່ເປັນມືອາຊີບ ຫຼື ຂໍ້ຄວາມທຳມະດາເບິ່ງແຂງກະດ້າງເກີນໄປ.
 Doctranslate API ຊ່ວຍຈັດການເລື່ອງນີ້ຜ່ານພາຣາມິເຕີ `tone`, ບ່ອນທີ່ທ່ານສາມາດລະບຸ `Serious` ສຳລັບເອກະສານທາງການ ຫຼື `Casual` ສຳລັບເອກະສານທີ່ບໍ່ເປັນທາງການ, ເພື່ອຮັບປະກັນວ່າການແປຈະສອດຄ່ອງກັບບໍລິບົດທີ່ທ່ານຕັ້ງໃຈໄວ້.
ການຈັດການຄວາມສອດຄ່ອງຂອງເພດ ແລະ ຈຳນວນ
ຄຸນສົມບັດທີ່ສຳຄັນຂອງພາສາສະເປນແມ່ນຄວາມສອດຄ່ອງທາງໄວຍາກອນ, ບ່ອນທີ່ຄຳນາມ, ຄຳນຳໜ້ານາມ, ແລະ ຄຳຄຸນນາມຕ້ອງກົງກັນໃນເພດ (ເພດຊາຍ/ເພດຍິງ) ແລະ ຈຳນວນ (ເອກະພົດ/ພະຫູພົດ).
 ການແປແບບຄຳຕໍ່ຄຳງ່າຍໆສາມາດລົ້ມເຫຼວໃນຈຸດນີ້ໄດ້ຢ່າງງ່າຍດາຍ, ເຊິ່ງສ້າງປະໂຫຍກທີ່ຜິດໄວຍາກອນ ແລະ ຟັງແລ້ວບໍ່ເປັນທຳມະຊາດ.
 ເຄື່ອງມືແປທີ່ຊັບຊ້ອນ, ເຊັ່ນດຽວກັບເຄື່ອງມືທີ່ຂັບເຄື່ອນ Doctranslate API, ໃຊ້ແບບຈຳລອງ AI ທີ່ກ້າວໜ້າເພື່ອຈັດການກັບກົດໄວຍາກອນທີ່ຊັບຊ້ອນເຫຼົ່ານີ້ຢ່າງຖືກຕ້ອງເພື່ອໃຫ້ໄດ້ຜົນລັບທີ່ລຽບງ່າຍ ແລະ ຖືກຕ້ອງ.
ພາສາສະເປນສຳນຽງທ້ອງຖິ່ນ
ພາສາສະເປນຖືກເວົ້າແຕກຕ່າງກັນໄປທົ່ວໂລກ, ໂດຍມີຄວາມແຕກຕ່າງທີ່ເຫັນໄດ້ຊັດເຈນໃນຄຳສັບ, ສຳນວນ, ແລະ ການໃຊ້ຄຳເວົ້າລະຫວ່າງປະເທດສະເປນ (ພາສາສະເປນ Castilian) ແລະ ອາເມລິກາລາຕິນ.
 ຕົວຢ່າງ, ຄຳວ່າ ‘computer’ ແມ່ນ ‘ordenador’ ໃນປະເທດສະເປນ ແຕ່ເປັນ ‘computadora’ ໃນສ່ວນໃຫຍ່ຂອງອາເມລິກາລາຕິນ.
 ໃນຂະນະທີ່ API ໃຫ້ການແປພາສາສະເປນແບບທົ່ວໄປ, ນັກພັດທະນາທີ່ສ້າງແອັບພລິເຄຊັນສຳລັບກຸ່ມເປົ້າໝາຍໃນພາກພື້ນສະເພາະຄວນລະວັງຄວາມແຕກຕ່າງເຫຼົ່ານີ້ ແລະ ອາດຈະຕ້ອງມີການກວດສອບຄັ້ງສຸດທ້າຍສຳລັບຄຳສັບສະເພາະຂອງພາກພື້ນນັ້ນໆ.
ຕົວອັກສອນພິເສດ ແລະ ເຄື່ອງໝາຍກຳກັບສຽງ
ຕົວອັກສອນພາສາສະເປນລວມມີຕົວອັກສອນພິເສດ ແລະ ເຄື່ອງໝາຍກຳກັບສຽງ ເຊັ່ນ ‘ñ’, ‘á’, ‘é’, ‘í’, ‘ó’, ‘ú’, ແລະ ‘ü’.
 ມັນສຳຄັນຢ່າງຍິ່ງທີ່ຂະບວນການເຮັດວຽກທັງໝົດຂອງທ່ານ, ຕັ້ງແຕ່ການອ່ານໄຟລ໌ຕົ້ນສະບັບໄປຈົນເຖິງການສົ່ງຄຳຮ້ອງຂໍ API ແລະ ການບັນທຶກເອກະສານສຸດທ້າຍ, ຕ້ອງໃຊ້ການເຂົ້າລະຫັດ UTF-8 ຢ່າງສະໝ່ຳສະເໝີ.
 ການບໍ່ສາມາດຈັດການການເຂົ້າລະຫັດໄດ້ຢ່າງຖືກຕ້ອງສາມາດສົ່ງຜົນໃຫ້ຕົວອັກສອນເຫຼົ່ານີ້ຖືກແທນທີ່ດ້ວຍເຄື່ອງໝາຍຄຳຖາມ ຫຼື ສັນຍາລັກທີ່ສັບສົນອື່ນໆ, ເຊິ່ງເຮັດໃຫ້ PDF ທີ່ແປແລ້ວສຸດທ້າຍເສຍຫາຍ ແລະ ອ່ານບໍ່ໄດ້.
ບົດສະຫຼຸບ ແລະ ຂັ້ນຕອນຕໍ່ໄປ
ການແປເອກະສານ PDF ຈາກພາສາອັງກິດເປັນພາສາສະເປນແບບອັດຕະໂນມັດເປັນວຽກທີ່ຊັບຊ້ອນ, ແຕ່ Doctranslate API ໃຫ້ວິທີແກ້ໄຂທີ່ມີປະສິດທິພາບ ແລະ ສະຫງ່າງາມ.
 ໂດຍການແກ້ໄຂຄວາມທ້າທາຍທີ່ຍາກລຳບາກຂອງການຮັກສາຮູບແບບ, ການສະກັດຂໍ້ຄວາມ, ແລະ ຄວາມແຕກຕ່າງທາງພາສາ, ມັນຊ່ວຍໃຫ້ນັກພັດທະນາສາມາດສ້າງແອັບພລິເຄຊັນລະດັບໂລກທີ່ຊັບຊ້ອນໄດ້ຢ່າງງ່າຍດາຍ.
 ຂະບວນການເຮັດວຽກແບບ asynchronous, RESTful ຮັບປະກັນການເຊື່ອມໂຍງທີ່ສາມາດຂະຫຍາຍໄດ້ ແລະ ມີປະສິດທິພາບເຂົ້າກັບໂຄງການຊອບແວທີ່ທັນສະໄໝໃດໆ.
ຄູ່ມືນີ້ໄດ້ນຳພາທ່ານຜ່ານຂະບວນການທັງໝົດ, ຕັ້ງແຕ່ການທຳຄວາມເຂົ້າໃຈບັນຫາຫຼັກຈົນເຖິງການຈັດຕັ້ງປະຕິບັດວິທີແກ້ໄຂທີ່ສົມບູນໃນ Python.
 ດ້ວຍພື້ນຖານນີ້, ຕອນນີ້ທ່ານສາມາດໃຊ້ API ເພື່ອແປເອກະສານ PDF ຂອງທ່ານໄດ້ຢ່າງໝັ້ນໃຈ ໃນຂະນະທີ່ຮັກສາຄຸນນະພາບ ແລະ ການຈັດຮູບແບບແບບມືອາຊີບຂອງມັນໄວ້.
 ສຳລັບຄຸນສົມບັດທີ່ກ້າວໜ້າກວ່າ ແລະ ລາຍລະອຽດສະເພາະຂອງຈຸດເຊື່ອມຕໍ່, ໃຫ້ອ້າງອີງເຖິງເອກະສານສຳລັບນັກພັດທະນາຂອງ Doctranslate ຢ່າງເປັນທາງການສະເໝີເພື່ອສຳຫຼວດຄວາມສາມາດເຕັມຮູບແບບ.