跳转到内容

നിങ്ങളുടെ ആപ്പിലേക്ക് ഡോക്യുമെൻ്റ് വർക്ക്ഫ്ലോകൾ കൊണ്ടുവരിക

ഒരു ഫയൽ അപ്‌ലോഡ് ചെയ്യുന്നത് മുതൽ അത് വിവർത്തനം ചെയ്യുക, പുരോഗതി പരിശോധിക്കുക, ഫലം ഡൗൺലോഡ് ചെയ്യുക. ഫയൽ മാനേജ്‌മെൻ്റ്, ഡോക്യുമെൻ്റ് പ്രോസസ്സിംഗ്, ഓഡിയോ, വീഡിയോ സേവനങ്ങൾ എന്നിവയ്‌ക്കായുള്ള എൻട്രി പോയിൻ്റുകൾക്കൊപ്പം നിങ്ങൾ സംയോജിപ്പിക്കുന്ന ക്രമത്തിൽ ഓരോ ഘട്ടവും വിശദീകരിച്ചിരിക്കുന്നു.

Base URL https://omnidoc.top/api/v1 · HTTPS · JSON · API കീ പ്രാമാണീകരണം · ഫയൽ വിവർത്തനം അസിൻക്രണസ് ജോലികളായി പ്രവർത്തിക്കുന്നു

ഈ സൈറ്റ് ക്ലൗഡ് HTTP API വിവരിക്കുന്നു.

01 ക്രെഡിറ്റുകളില്ലാത്ത ഒരു അഭ്യർത്ഥനയോടെ ആരംഭിക്കുക

Section titled “01 ക്രെഡിറ്റുകളില്ലാത്ത ഒരു അഭ്യർത്ഥനയോടെ ആരംഭിക്കുക”

ഫയലുകൾ അപ്‌ലോഡ് ചെയ്യുന്നതിന് മുമ്പ് നിങ്ങളുടെ കീയും നെറ്റ്‌വർക്കും പ്രവർത്തിക്കുന്നുവെന്ന് സ്ഥിരീകരിക്കുക. ഒരു ബാലൻസ് പരിശോധനയ്ക്ക് ക്രെഡിറ്റുകളൊന്നും നൽകേണ്ടതില്ല, വിവർത്തന ജോലിയൊന്നും സൃഷ്ടിക്കുന്നില്ല.

  1. ഒരു API കീ നേടുക

    API കൺസോളിൽ സൈൻ ഇൻ ചെയ്‌ത് sk_ എന്ന് തുടങ്ങുന്ന ഒരു കീ സൃഷ്‌ടിക്കുക. ഓരോ ആപ്ലിക്കേഷനും ഒരു പ്രത്യേക കീ ഉപയോഗിക്കുക, അതിന് ഒരു ബജറ്റ് നൽകുക.

    അത് സൃഷ്‌ടിച്ച അക്കൌണ്ടിനായി ഒരു കീ പ്രവർത്തിക്കുന്നു. ഇത് സെർവറിൽ സൂക്ഷിച്ച് ഒരു പരിസ്ഥിതി വേരിയബിളിൽ നിന്ന് വായിക്കുക; അത് ഒരിക്കലും വെബ് പേജ് ഉറവിടത്തിലോ പൊതു ശേഖരത്തിലോ ഇടരുത്.

  2. ബാലൻസ് പരിശോധിക്കുക

    പരിസ്ഥിതി വേരിയബിൾ OMNIDOC_API_KEY സജ്ജമാക്കുക, തുടർന്ന് ചുവടെയുള്ള ഏതെങ്കിലും ഉദാഹരണങ്ങൾ പ്രവർത്തിപ്പിക്കുക. വിജയം തിരികെ നൽകുന്നു JSON; 401 എന്നതിനർത്ഥം കീക്ക് ഒരു പ്രശ്‌നമുണ്ടെന്നും പരിശോധന ആവശ്യമാണെന്നും അർത്ഥമാക്കുന്നു. ടിക്കറ്റുകളിലോ സ്ക്രീൻഷോട്ടുകളിലോ ലോഗുകളിലോ ഒരിക്കലും മുഴുവൻ കീയും കാണിക്കരുത്.

    Terminal window
    export OMNIDOC_API_KEY="sk_your_key"
    curl --fail-with-body --silent --show-error \
    'https://omnidoc.top/api/v1/billing/credits/balance' \
    -H "X-API-Key: $OMNIDOC_API_KEY"

02 ഒരു ഫയലിൽ നിന്ന് വിവർത്തനത്തിലേക്ക്

Section titled “02 ഒരു ഫയലിൽ നിന്ന് വിവർത്തനത്തിലേക്ക്”

വിജയകരമായ അപ്‌ലോഡ് എന്നതിനർത്ഥം ഫയൽ സംഭരിച്ചിരിക്കുന്നു എന്നാണ്. നിങ്ങൾ ഒരു ജോലി സൃഷ്‌ടിച്ചതിന് ശേഷം, അത് അന്തിമ അവസ്ഥയിലെത്തുന്നത് വരെ കാത്തിരിക്കുക, തുടർന്ന് അതിൻ്റെ ഫലങ്ങൾ ലിസ്റ്റ് ചെയ്ത് ഡൗൺലോഡ് ചെയ്യുക.

ഘട്ടംരീതിയും വഴിയുംഎന്താണ് സൂക്ഷിക്കേണ്ടത്
ഒരു അപ്‌ലോഡ് അഭ്യർത്ഥിക്കുകPOST /upload/presignupload_url, upload_headers, finalize_token
ഫയൽ അയയ്ക്കുകPUT മുതൽ തിരികെ upload_url വരെവിജയകരമായ പ്രതികരണം; ഈ അഭ്യർത്ഥനയ്ക്ക് API കീ ഇല്ല
അപ്‌ലോഡ് സ്ഥിരീകരിക്കുകPOST /upload/finalizedocument.id
ഒരു വിവർത്തനം സൃഷ്ടിക്കുകPOST /jobsജോലി id
നില പരിശോധിക്കുകGET /jobs/{job_id}completed അല്ലെങ്കിൽ failed
ഫലങ്ങൾ പട്ടികപ്പെടുത്തുകGET /artifacts?job_id={job_id}ആർട്ടിഫാക്റ്റ് ഐഡികളും ഫോർമാറ്റുകളും
ഒരു ഫലം ഡൗൺലോഡ് ചെയ്യുകGET /artifacts/{artifact_id}/downloadഫയൽ ബൈറ്റുകളും പ്രതികരണ ഫയലിൻ്റെ പേരും

നേരിട്ടുള്ള അപ്‌ലോഡിനായി, സെർവറിൽ നിന്ന് കൃത്യമായി upload_headers അയയ്ക്കുക, സ്റ്റോറേജ് വിലാസത്തിലേക്ക് ഒരിക്കലും X-API-Key അയയ്ക്കരുത്. അപ്‌ലോഡ് വിലാസം കാലഹരണപ്പെടുകയോ കൈമാറ്റം പരാജയപ്പെടുകയോ ചെയ്താൽ, പുതിയൊരെണ്ണം അഭ്യർത്ഥിക്കുക. വിശദാംശങ്ങൾ: അപ്‌ലോഡ് പ്രോട്ടോക്കോൾ, ദ്രുത ആരംഭം, Node.js വർക്ക്ഫ്ലോ പൂർത്തിയാക്കുക, വിവർത്തന അഭ്യർത്ഥന ഫീൽഡുകൾ.

03 നിങ്ങളുടെ ടാസ്ക്കിൻ്റെ അവസാന പോയിൻ്റ് കണ്ടെത്തുക

Section titled “03 നിങ്ങളുടെ ടാസ്ക്കിൻ്റെ അവസാന പോയിൻ്റ് കണ്ടെത്തുക”

ഓരോ എൻട്രിയും പാതകളും അഭ്യർത്ഥന ഫീൽഡുകളും ഉദാഹരണങ്ങളും പട്ടികപ്പെടുത്തുന്നു. നിങ്ങളുടെ അക്കൗണ്ടിൻ്റെ സേവന നിലയും കീയുടെ പരിധികളും അവയ്‌ക്കെല്ലാം ബാധകമാണ്.

04 പ്രാമാണീകരണവും ഉറവിട ഉടമസ്ഥതയും

Section titled “04 പ്രാമാണീകരണവും ഉറവിട ഉടമസ്ഥതയും”

ഒരു API കീ ഒരു അക്കൗണ്ട് തിരിച്ചറിയുന്നു. ഇത് ഒരു ഫയലിനുള്ള പൊതു ഡൗൺലോഡ് പാസ്‌വേഡല്ല.

അഭ്യർത്ഥന തലക്കെട്ട്

ഓരോ അഭ്യർത്ഥനയിലും രണ്ടിൽ ഒന്ന് X-API-Key: sk_… അല്ലെങ്കിൽ Authorization: Bearer sk_… ഉപയോഗിക്കുക. JSON ബോഡികൾക്കൊപ്പം Content-Type: application/json അയയ്‌ക്കുക.

എത്ര താക്കോൽ എത്താൻ കഴിയും

ഒരു കീ അതിൻ്റെ അക്കൗണ്ട് ഉപയോഗിച്ചേക്കാവുന്ന ഉറവിടങ്ങളിൽ മാത്രമേ എത്തിച്ചേരുകയുള്ളൂ; സേവന നില, കീയുടെ ബജറ്റ്, അനുവദനീയമായ വിവർത്തന ക്രമീകരണങ്ങൾ എന്നിവ ഇപ്പോഴും ബാധകമാണ്. അക്കൗണ്ട് മാറ്റങ്ങളും കീകൾ സൃഷ്‌ടിക്കുന്നതും റൊട്ടേറ്റുചെയ്യുന്നതും അസാധുവാക്കുന്നതും കൺസോളിൽ സംഭവിക്കുന്നു.

ആധികാരികത, ബജറ്റുകൾ, റൊട്ടേഷൻ കൂടാതെ സേവനങ്ങളും അനുമതികളും എന്നിവ കാണുക.

05 സംയോജനത്തിൽ പരാജയം കൈകാര്യം ചെയ്യുക

Section titled “05 സംയോജനത്തിൽ പരാജയം കൈകാര്യം ചെയ്യുക”

കാലഹരണപ്പെടൽ എന്നതിനർത്ഥം ജോലി സൃഷ്ടിച്ചിട്ടില്ലെന്ന് അർത്ഥമാക്കുന്നില്ല. പരിഹരിക്കേണ്ട അഭ്യർത്ഥനകൾ കൂടാതെ വീണ്ടും ശ്രമിക്കാവുന്ന പിശകുകൾ പറയുക, അതിനാൽ ഒന്നും രണ്ടുതവണ സമർപ്പിക്കുകയോ പ്രോസസ്സ് ചെയ്യുകയോ ചെയ്യുന്നില്ല.

  • ഐഡമ്പറ്റൻ്റ് സൃഷ്‌ടി: ഓരോ പുതിയ സൃഷ്‌ടി പ്രവർത്തനത്തിനും ഒരു Idempotency-Key സൃഷ്‌ടിക്കുക; നിങ്ങൾ അതേ പ്രവർത്തനം വീണ്ടും ശ്രമിക്കുമ്പോൾ, യഥാർത്ഥ കീയും അതേ അഭ്യർത്ഥന ബോഡിയും വീണ്ടും ഉപയോഗിക്കുക. പ്രമാണ പ്രവർത്തനങ്ങൾ, മീഡിയ ജോലികൾ, ശബ്ദം സൃഷ്ടിക്കൽ എന്നിവയ്‌ക്ക് കീ ആവശ്യമാണ്; മറ്റ് സൃഷ്‌ടി എൻഡ് പോയിൻ്റുകൾക്കായി അവയുടെ റഫറൻസ് പേജുകൾ കാണുക.
  • അസിൻക്രണസ് അറിയിപ്പുകൾ: ആദ്യ സംയോജനത്തിന് പോളിംഗ് നല്ലതാണ്; തുടർച്ചയായ പുരോഗതി ഉപയോഗിക്കുന്നതിന് SSE, പശ്ചാത്തലത്തിൽ അന്തിമ അവസ്ഥകൾ ലഭിക്കുന്നതിന് webhook ഉപയോഗിക്കുക.
നിലആദ്യം പരിശോധിക്കുകഎന്തുചെയ്യും
401 / 403കീ, അനുമതികൾ, വിഭവ ഉടമസ്ഥാവകാശംക്രെഡൻഷ്യലുകളോ അനുമതികളോ പരിഹരിക്കുക; അന്ധമായി വീണ്ടും ശ്രമിക്കരുത്
402ലഭ്യമായ ക്രെഡിറ്റുകൾടോപ്പ് അപ്പ്, തുടർന്ന് വീണ്ടും സമർപ്പിക്കുക
409ഐഡംപോട്ടൻസി കീയും ബോഡിയും, റിസോഴ്സ് സ്റ്റേറ്റ്പുതിയത് ആരംഭിക്കുന്നതിന് മുമ്പ് യഥാർത്ഥ പ്രവർത്തനം അന്വേഷിക്കുക
422പ്രതികരണത്തിലെ ഫീൽഡ് പിശകുകൾപാരാമീറ്ററുകൾ അല്ലെങ്കിൽ ഫയൽ ശരിയാക്കുക
429ബിസിനസ് code, Retry-Afterനിരക്കും ക്യൂ പരിധിയും കാത്തിരിക്കാം; ഉപയോഗിച്ച കീ ബജറ്റ് ആദ്യം ഉയർത്തണം
5xxതാൽക്കാലിക സേവന പിശക്ബൗണ്ടഡ് എക്‌സ്‌പോണൻഷ്യൽ ബാക്ക്ഓഫ്; അഭ്യർത്ഥനകൾ സൃഷ്ടിക്കുന്നതിന് ഐഡമ്പറ്റൻസി കീ സൂക്ഷിക്കുക

X-Request-Id പ്രതികരണ തലക്കെട്ടും അഭ്യർത്ഥന സമയവും ട്രബിൾഷൂട്ടിംഗിനുള്ള പാതയും സൂക്ഷിക്കുക; പൂർണ്ണ കീ ഒരിക്കലും ലോഗ് ചെയ്യരുത്. എല്ലാ പിശക് കോഡുകളും വീണ്ടും ശ്രമിക്കുന്നതിനുള്ള ഉദാഹരണങ്ങളും പിശക് റഫറൻസ് എന്നതിലാണ്.

06 നിങ്ങൾ സംയോജിപ്പിക്കുന്നതിന് മുമ്പ് ബില്ലിംഗ് എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്ന് പരിശോധിക്കുക

Section titled “06 നിങ്ങൾ സംയോജിപ്പിക്കുന്നതിന് മുമ്പ് ബില്ലിംഗ് എങ്ങനെ പ്രവർത്തിക്കുന്നുവെന്ന് പരിശോധിക്കുക”

ക്രെഡിറ്റുകളൊന്നുമില്ല

അപ്‌ലോഡ് ചെയ്യുന്നതിനും ജോലികൾ പരിശോധിക്കുന്നതിനും ഫലങ്ങൾ ഡൗൺലോഡ് ചെയ്യുന്നതിനും ബാലൻസ്, സെറ്റിൽമെൻ്റ് റെക്കോർഡുകൾ വായിക്കുന്നതിനും ക്രെഡിറ്റുകൾ ആവശ്യമില്ല; ഗ്ലോസറികൾ, പ്രോജക്റ്റുകൾ, ടാഗുകൾ, തിരയൽ, പങ്കിടൽ എന്നിവയുമില്ല.

ഉപയോഗം അനുസരിച്ച് ബിൽ ചെയ്യുന്നു

ഫയൽ വിവർത്തനം, ഡോക്യുമെൻ്റ് ടൂളുകൾ, തൽക്ഷണ വിവർത്തനം, ഓഡിയോ, വീഡിയോ സേവനങ്ങൾ എന്നിവ യഥാർത്ഥ ഉപയോഗം അനുസരിച്ച് അവയുടെ വിലകളിൽ തീർപ്പാക്കുന്നു; ഒരു ജോലി സൃഷ്ടിക്കുക എന്നത് അന്തിമ ചാർജ്ജല്ല.

ഒരു ജോലി ആരംഭിക്കുന്നതിന് മുമ്പ്, ബാലൻസ് ത്രെഷോൾഡ് മാത്രമേ പരിശോധിക്കൂ; അത് പൂർത്തിയായ ശേഷം, യഥാർത്ഥ ഉപയോഗത്തിന് നിരക്ക് ഈടാക്കും. ബാലൻസ് കുറവാണെങ്കിൽ, വ്യത്യാസം കടമായി രേഖപ്പെടുത്തുകയും പിന്നീട് വരുന്ന ക്രെഡിറ്റുകൾ ആദ്യം അത് അടയ്ക്കുകയും ചെയ്യും. ഓരോ ജോലിക്കും ഓരോ ക്രെഡിറ്റ് പ്രവർത്തനത്തിനും നിരക്കുകളും റീഫണ്ടുകളും നിങ്ങൾക്ക് അനുരഞ്ജിപ്പിക്കാനാകും. ഒരു കീയുടെ ബജറ്റ് ഉപയോഗിക്കുമ്പോൾ, ആ കീയുടെ കീഴിലുള്ള ജോലികളും ഫലങ്ങളും റെക്കോർഡുകളും നിങ്ങൾക്ക് തുടർന്നും അന്വേഷിക്കാനാകും.