ഒരു വിവർത്തന ജോലി സൃഷ്ടിക്കുക
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonഅഭ്യർത്ഥിക്കുക
Section titled “അഭ്യർത്ഥിക്കുക”| ഫീൽഡ് | ടൈപ്പ് ചെയ്യുക | ആവശ്യമാണ് | സ്ഥിരസ്ഥിതി | വിവരണം |
|---|---|---|---|---|
document_id | ചരട് | ✅ | — | സ്ഥിരീകരിച്ച ഒരു പ്രമാണത്തിൻ്റെ ഐഡി |
target_lang | ചരട് | ✅ | — | ടാർഗെറ്റ് ഭാഷാ കോഡ് |
source_lang | ചരട് | — | സ്വയമേവ കണ്ടെത്തുക | ഉറവിട ഭാഷാ കോഡ് |
engine | ചരട് | — | xr-397b | വിവർത്തന ക്രമീകരണ ഐഡി, വിവർത്തന ക്രമീകരണങ്ങൾ കാണുക |
output_mode | ചരട് | — | bilingual | single അല്ലെങ്കിൽ bilingual |
glossary_id | ചരട് | — | — | ഈ അക്കൗണ്ടിൻ്റെ ഒരു ഗ്ലോസറി ഐഡി. ഗ്ലോസറികൾ അക്കൗണ്ടുകൾ അടയ്ക്കുന്നതിനുള്ളതാണ് (കുറഞ്ഞത് ഒരു വിജയകരമായ പേയ്മെൻ്റെങ്കിലും); ഒരാൾക്ക് അയയ്ക്കുന്ന പണമടയ്ക്കാത്ത അക്കൗണ്ടിന് 403 ലഭിക്കും |
include_images | ബൂളിയൻ | — | false | ഡോക്യുമെൻ്റിൻ്റെ ചിത്രങ്ങളിലെ വാചകവും വിവർത്തനം ചെയ്യുക |
context_translation | ബൂളിയൻ | — | false | സന്ദർഭ മെച്ചപ്പെടുത്തൽ ഓണാക്കുക |
style_preset | ചരട് | — | — | സ്റ്റൈൽ പ്രീസെറ്റ് |
സൃഷ്ടിച്ച ജോലി ക്യൂവിൽ പ്രവേശിക്കുന്നു. ഓരോ അക്കൗണ്ടും ഒരു സമയം 5 ഫയലുകൾ വരെ പ്രോസസ്സ് ചെയ്യുന്നു; കൂടുതൽ ജോലികൾ ഇപ്പോഴും സൃഷ്ടിക്കപ്പെടുകയും സ്വയമേവ ക്യൂ നിൽക്കുകയും ചെയ്യുന്നു, നേരത്തെയുള്ളവ പൂർത്തിയാകുമ്പോൾ ആരംഭിക്കുന്നു. ഒരു ജോലി കാത്തിരിക്കുമ്പോൾ, എത്ര ജോലികൾ മുന്നിലുണ്ടെന്ന് അതിൻ്റെ stage_message പറയുന്നു.
ഒരു ജോലി ആരംഭിക്കുന്നതിന് മുമ്പ്, ഒരു പരിധിയിൽ ബാലൻസ് പരിശോധിക്കുന്നു: ഒരു PDF-ന് “പേജുകൾ × 2 ക്രെഡിറ്റുകൾ” എന്നതിന് മുകളിലുള്ള ബാലൻസ് ആവശ്യമാണ്; മറ്റ് ഫോർമാറ്റുകൾ സോഴ്സ് ടെക്സ്റ്റിൻ്റെ ദൈർഘ്യം, കുറഞ്ഞത് 2 ക്രെഡിറ്റുകൾ. ബാലൻസ് ഒരു ഫയൽ ആരംഭിക്കാൻ കഴിയുന്നില്ലെങ്കിൽ, ആ ജോലി status=failed, quota_exceeded=true എന്നിവയിൽ അവസാനിക്കും, ഒന്നും ഈടാക്കില്ല, മറ്റ് ജോലികളെ ബാധിക്കില്ല. ഒരു ജോലി പൂർത്തിയാകുമ്പോൾ, യഥാർത്ഥ ഉപയോഗത്തിന് നിരക്ക് ഈടാക്കുന്നു; ചെലവ് ബാലൻസ് കവിയുന്നുവെങ്കിൽ, ബാലൻസ് നെഗറ്റീവ് ആകും, പിന്നീട് വരുന്ന ക്രെഡിറ്റുകൾ ആദ്യം കടം വീട്ടും, ബാലൻസ് നെഗറ്റീവ് ആയിരിക്കുമ്പോൾ പുതിയ ജോലികൾ ആരംഭിക്കാൻ കഴിയില്ല, അതിനാൽ ടോപ്പ് അപ്പ് ചെയ്യുക. ക്രെഡിറ്റുകളും ഉപയോഗവും കാണുക.
ഉദാഹരണം
Section titled “ഉദാഹരണം”curl --fail-with-body -X POST https://omnidoc.top/api/v1/jobs \ -H "X-API-Key: $OMNIDOC_API_KEY" \ -H "Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f" \ -H "Content-Type: application/json" \ -d '{"document_id":"4q8mx2q9z1k7p6ra","target_lang":"en"}'പ്രതികരണം 201 (സെർവറിൻ്റെ stage_message ചൈനീസ് ഭാഷയിലാണ്):
{ "id": "q3f8s6c2a9m1k4tx", "document_id": "4q8mx2q9z1k7p6ra", "source_lang": null, "target_lang": "en", "engine": "xr-397b", "status": "pending", "stage": "queued", "stage_progress": 0, "stage_message": "排队中", "time_cost": 0, "error_msg": null, "quota_exceeded": false, "queue_position": null, "created_at": "2026-10-01T12:01:00Z", "updated_at": "2026-10-01T12:01:00Z"}പിശകുകൾ
Section titled “പിശകുകൾ”| നില | കാരണം |
|---|---|
403 | കീ തിരഞ്ഞെടുത്ത ക്രമീകരണം അനുവദിക്കുന്നില്ല, അല്ലെങ്കിൽ അയച്ച പണമടയ്ക്കാത്ത അക്കൗണ്ട് glossary_id |
404 | പ്രമാണമോ ഗ്ലോസറിയോ നിലവിലില്ല, ഇല്ലാതാക്കി അല്ലെങ്കിൽ മറ്റൊരു അക്കൗണ്ടിൻ്റെതാണ് |
415 | ഫയൽ ഫോർമാറ്റ് വിവർത്തനം ചെയ്യാൻ കഴിയില്ല |
422 | ഫയൽ ശൂന്യമാണ്, വിവർത്തനം ചെയ്യാവുന്ന വാചകമില്ല, അല്ലെങ്കിൽ ഒരു പാരാമീറ്റർ അസാധുവാണ് |
429 | വളരെയധികം അഭ്യർത്ഥനകൾ, അല്ലെങ്കിൽ ക്യൂ നിറഞ്ഞിരിക്കുന്നു; Retry-After-ന് ശേഷം വീണ്ടും ശ്രമിക്കുക |
ഐഡമ്പറ്റൻസി
Section titled “ഐഡമ്പറ്റൻസി”Idempotency-Key ഓപ്ഷണൽ ആണ് എന്നാൽ എല്ലാ സമർപ്പിക്കലിനും ശുപാർശ ചെയ്യുന്നു. ഒരു കീ 1–128 ദൃശ്യമായ ASCII പ്രതീകങ്ങളാണ്, അതേ ക്രെഡൻഷ്യലിനായി അനിശ്ചിതമായി സാധുവായി തുടരുന്നു:
- ഒരേ കീ, ഒരേ ബോഡി: യഥാർത്ഥ ജോലി തിരികെ നൽകുന്നു (പരാജയപ്പെട്ടത് ഉൾപ്പെടെ); ഒന്നും സൃഷ്ടിക്കുകയോ രണ്ടുതവണ ചാർജ് ചെയ്യുകയോ ചെയ്യുന്നില്ല.
- ഒരേ കീ, വ്യത്യസ്ത ബോഡി:
409(idempotency_request_conflict). - യഥാർത്ഥ ജോലി ഇല്ലാതാക്കി:
410(idempotency_job_gone).
ഓരോ പുതിയ സമർപ്പണത്തിനും ഒരു പുതിയ UUID ഉപയോഗിക്കുക, അതേ സമർപ്പണം വീണ്ടും ശ്രമിക്കുമ്പോൾ മാത്രം യഥാർത്ഥ കീ വീണ്ടും ഉപയോഗിക്കുക.