跳转到内容

ഒരു വിവർത്തന ജോലി സൃഷ്ടിക്കുക

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json

അഭ്യർത്ഥിക്കുക

Section titled “അഭ്യർത്ഥിക്കുക”
ഫീൽഡ്ടൈപ്പ് ചെയ്യുകആവശ്യമാണ്സ്ഥിരസ്ഥിതിവിവരണം
document_idചരട്✅—സ്ഥിരീകരിച്ച ഒരു പ്രമാണത്തിൻ്റെ ഐഡി
target_langചരട്✅—ടാർഗെറ്റ് ഭാഷാ കോഡ്
source_langചരട്—സ്വയമേവ കണ്ടെത്തുകഉറവിട ഭാഷാ കോഡ്
engineചരട്—xr-397bവിവർത്തന ക്രമീകരണ ഐഡി, വിവർത്തന ക്രമീകരണങ്ങൾ കാണുക
output_modeചരട്—bilingualsingle അല്ലെങ്കിൽ bilingual
glossary_idചരട്——ഈ അക്കൗണ്ടിൻ്റെ ഒരു ഗ്ലോസറി ഐഡി. ഗ്ലോസറികൾ അക്കൗണ്ടുകൾ അടയ്ക്കുന്നതിനുള്ളതാണ് (കുറഞ്ഞത് ഒരു വിജയകരമായ പേയ്‌മെൻ്റെങ്കിലും); ഒരാൾക്ക് അയയ്ക്കുന്ന പണമടയ്ക്കാത്ത അക്കൗണ്ടിന് 403 ലഭിക്കും
include_imagesബൂളിയൻ—falseഡോക്യുമെൻ്റിൻ്റെ ചിത്രങ്ങളിലെ വാചകവും വിവർത്തനം ചെയ്യുക
context_translationബൂളിയൻ—falseസന്ദർഭ മെച്ചപ്പെടുത്തൽ ഓണാക്കുക
style_presetചരട്——സ്റ്റൈൽ പ്രീസെറ്റ്

സൃഷ്ടിച്ച ജോലി ക്യൂവിൽ പ്രവേശിക്കുന്നു. ഓരോ അക്കൗണ്ടും ഒരു സമയം 5 ഫയലുകൾ വരെ പ്രോസസ്സ് ചെയ്യുന്നു; കൂടുതൽ ജോലികൾ ഇപ്പോഴും സൃഷ്ടിക്കപ്പെടുകയും സ്വയമേവ ക്യൂ നിൽക്കുകയും ചെയ്യുന്നു, നേരത്തെയുള്ളവ പൂർത്തിയാകുമ്പോൾ ആരംഭിക്കുന്നു. ഒരു ജോലി കാത്തിരിക്കുമ്പോൾ, എത്ര ജോലികൾ മുന്നിലുണ്ടെന്ന് അതിൻ്റെ stage_message പറയുന്നു.

ഒരു ജോലി ആരംഭിക്കുന്നതിന് മുമ്പ്, ഒരു പരിധിയിൽ ബാലൻസ് പരിശോധിക്കുന്നു: ഒരു PDF-ന് “പേജുകൾ × 2 ക്രെഡിറ്റുകൾ” എന്നതിന് മുകളിലുള്ള ബാലൻസ് ആവശ്യമാണ്; മറ്റ് ഫോർമാറ്റുകൾ സോഴ്സ് ടെക്സ്റ്റിൻ്റെ ദൈർഘ്യം, കുറഞ്ഞത് 2 ക്രെഡിറ്റുകൾ. ബാലൻസ് ഒരു ഫയൽ ആരംഭിക്കാൻ കഴിയുന്നില്ലെങ്കിൽ, ആ ജോലി status=failed, quota_exceeded=true എന്നിവയിൽ അവസാനിക്കും, ഒന്നും ഈടാക്കില്ല, മറ്റ് ജോലികളെ ബാധിക്കില്ല. ഒരു ജോലി പൂർത്തിയാകുമ്പോൾ, യഥാർത്ഥ ഉപയോഗത്തിന് നിരക്ക് ഈടാക്കുന്നു; ചെലവ് ബാലൻസ് കവിയുന്നുവെങ്കിൽ, ബാലൻസ് നെഗറ്റീവ് ആകും, പിന്നീട് വരുന്ന ക്രെഡിറ്റുകൾ ആദ്യം കടം വീട്ടും, ബാലൻസ് നെഗറ്റീവ് ആയിരിക്കുമ്പോൾ പുതിയ ജോലികൾ ആരംഭിക്കാൻ കഴിയില്ല, അതിനാൽ ടോപ്പ് അപ്പ് ചെയ്യുക. ക്രെഡിറ്റുകളും ഉപയോഗവും കാണുക.

Terminal window
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"
}
നിലകാരണം
403കീ തിരഞ്ഞെടുത്ത ക്രമീകരണം അനുവദിക്കുന്നില്ല, അല്ലെങ്കിൽ അയച്ച പണമടയ്ക്കാത്ത അക്കൗണ്ട് glossary_id
404പ്രമാണമോ ഗ്ലോസറിയോ നിലവിലില്ല, ഇല്ലാതാക്കി അല്ലെങ്കിൽ മറ്റൊരു അക്കൗണ്ടിൻ്റെതാണ്
415ഫയൽ ഫോർമാറ്റ് വിവർത്തനം ചെയ്യാൻ കഴിയില്ല
422ഫയൽ ശൂന്യമാണ്, വിവർത്തനം ചെയ്യാവുന്ന വാചകമില്ല, അല്ലെങ്കിൽ ഒരു പാരാമീറ്റർ അസാധുവാണ്
429വളരെയധികം അഭ്യർത്ഥനകൾ, അല്ലെങ്കിൽ ക്യൂ നിറഞ്ഞിരിക്കുന്നു; Retry-After-ന് ശേഷം വീണ്ടും ശ്രമിക്കുക

Idempotency-Key ഓപ്ഷണൽ ആണ് എന്നാൽ എല്ലാ സമർപ്പിക്കലിനും ശുപാർശ ചെയ്യുന്നു. ഒരു കീ 1–128 ദൃശ്യമായ ASCII പ്രതീകങ്ങളാണ്, അതേ ക്രെഡൻഷ്യലിനായി അനിശ്ചിതമായി സാധുവായി തുടരുന്നു:

  • ഒരേ കീ, ഒരേ ബോഡി: യഥാർത്ഥ ജോലി തിരികെ നൽകുന്നു (പരാജയപ്പെട്ടത് ഉൾപ്പെടെ); ഒന്നും സൃഷ്ടിക്കുകയോ രണ്ടുതവണ ചാർജ് ചെയ്യുകയോ ചെയ്യുന്നില്ല.
  • ഒരേ കീ, വ്യത്യസ്ത ബോഡി: 409 (idempotency_request_conflict).
  • യഥാർത്ഥ ജോലി ഇല്ലാതാക്കി: 410 (idempotency_job_gone).

ഓരോ പുതിയ സമർപ്പണത്തിനും ഒരു പുതിയ UUID ഉപയോഗിക്കുക, അതേ സമർപ്പണം വീണ്ടും ശ്രമിക്കുമ്പോൾ മാത്രം യഥാർത്ഥ കീ ​​വീണ്ടും ഉപയോഗിക്കുക.