ఒక అనువాద పనిని సృష్టించండి
POST /api/v1/jobsIdempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402fContent-Type: application/jsonఅభ్యర్థన
Section titled “అభ్యర్థన”| క్షేత్రం | రకం | అవసరం | ప్రిడిఫాల్ట్ | వివరణ |
|---|---|---|---|---|
document_id | string | ✅ | — | ధృవీకరించబడిన పత్రం యొక్క ID |
target_lang | string | ✅ | — | లక్ష్య భాష కోడ్ |
source_lang | string | — | ఆటో-గుర్తింపు | స్టైల్ అవసరం: క్లుప్తమైన సాంకేతిక రచనను ఉపయోగించండి. ఉత్పత్తి పేర్లు, కోడ్ గుర్తింపులు, ఫైల్ మార్గాలు, యూనిట్లు మరియు సంక్షిప్త పదాలను ప్రామాణిక స్థానికీకరించబడిన పదం లేనిదే మార్చకుండా ఉంచండి. |
engine | string | — | xr-397b | అనువాద సెట్టింగ్ ఐడీ, అనువాద సెట్టింగ్లు చూడండి |
output_mode | string | — | bilingual | single లేదా bilingual |
glossary_id | string | — | — | ఈ ఖాతాకు ఒక గ్లోసరీ ID. గ్లోసరీలు చెల్లింపు ఖాతాల కోసం (కనీసం ఒక విజయవంతమైన చెల్లింపు ఉండాలి); చెల్లింపు లేని ఖాతా ఒకటి పంపితే 403 పొందుతుంది |
include_images | బూలియన్ | — | false | అలాగే డాక్యుమెంట్లోని చిత్రాలలోని పాఠ్యాన్ని కూడా అనువదించండి |
context_translation | బూలియన్ | — | false | సందర్భ మెరుగుదలను ప్రారంభించండి |
style_preset | string | — | — | స్టైల్ ప్రీసెట్ |
సృష్టించబడిన పని క్యూలోకి ప్రవేశిస్తుంది. ప్రతి ఖాతా ఒకేసారి 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ని ఉపయోగించండి, మరియు అదే సబ్మిషన్ను మళ్లీ ప్రయత్నించేటప్పుడు మాత్రమే అసలు కీని తిరిగి ఉపయోగించండి.