மொழிபெயர்ப்புப் பணியை உருவாக்குங்கள்
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonகோரிக்கை
Section titled “கோரிக்கை”| புலம் | வகை | தேவைப்படுகிறது | இடைமுக விருப்பங்கள் | விளக்கம் |
|---|---|---|---|---|
document_id | சரம் | ✅ | — | உறுதிப்படுத்தப்பட்ட ஆவணத்தின் ID |
target_lang | சரம் | ✅ | — | இலக்கு மொழி குறியீடு |
source_lang | சரம் | — | தானியங்கி கண்டறிதல் | மூல மொழி குறியீடு |
engine | சரம் | — | xr-397b | மொழிபெயர்ப்பு அமைப்பு ID, மொழிபெயர்ப்பு அமைப்புகள்-ஐப் பார்க்கவும். |
output_mode | சரம் | — | bilingual | single அல்லது bilingual |
glossary_id | சரம் | — | — | இந்தக் கணக்கின் சொல்லகராதி அடையாளம். சொல்லகராதிகள் கட்டணம் செலுத்தப்பட்ட கணக்குகளுக்கானது (குறைந்தபட்சம் ஒரு வெற்றிகரமான கட்டணம்); கட்டணம் செலுத்தப்படாத கணக்கு ஒன்றை அனுப்பும்போது 403 கிடைக்கும். |
include_images | boolean | — | false | மேலும், ஆவணத்தின் படங்களில் உள்ள உரையையும் மொழிபெயர்க்கவும். |
context_translation | boolean | — | 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 ஐப் பயன்படுத்தவும், அதே சமர்ப்பிப்பை மீண்டும் முயற்சிக்கும்போது மட்டுமே அசல் விருப்பத்தை மீண்டும் பயன்படுத்தவும்.