跳转到内容

ఒక అనువాద పనిని సృష్టించండి

POST /api/v1/jobs
Idempotency-Key: 7a40d1c7-6ee8-4cc1-b74b-132792bd402f
Content-Type: application/json
క్షేత్రంరకంఅవసరంప్రిడిఫాల్ట్వివరణ
document_idstring✅—ధృవీకరించబడిన పత్రం యొక్క ID
target_langstring✅—లక్ష్య భాష కోడ్
source_langstring—ఆటో-గుర్తింపుస్టైల్ అవసరం: క్లుప్తమైన సాంకేతిక రచనను ఉపయోగించండి. ఉత్పత్తి పేర్లు, కోడ్ గుర్తింపులు, ఫైల్ మార్గాలు, యూనిట్‌లు మరియు సంక్షిప్త పదాలను ప్రామాణిక స్థానికీకరించబడిన పదం లేనిదే మార్చకుండా ఉంచండి.
enginestring—xr-397bఅనువాద సెట్టింగ్ ఐడీ, అనువాద సెట్టింగ్‌లు చూడండి
output_modestring—bilingualsingle లేదా bilingual
glossary_idstring——ఈ ఖాతాకు ఒక గ్లోసరీ ID. గ్లోసరీలు చెల్లింపు ఖాతాల కోసం (కనీసం ఒక విజయవంతమైన చెల్లింపు ఉండాలి); చెల్లింపు లేని ఖాతా ఒకటి పంపితే 403 పొందుతుంది
include_imagesబూలియన్—falseఅలాగే డాక్యుమెంట్‌లోని చిత్రాలలోని పాఠ్యాన్ని కూడా అనువదించండి
context_translationబూలియన్—falseసందర్భ మెరుగుదలను ప్రారంభించండి
style_presetstring——స్టైల్ ప్రీసెట్

సృష్టించబడిన పని క్యూలోకి ప్రవేశిస్తుంది. ప్రతి ఖాతా ఒకేసారి 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ని ఉపయోగించండి, మరియు అదే సబ్‌మిషన్‌ను మళ్లీ ప్రయత్నించేటప్పుడు మాత్రమే అసలు కీని తిరిగి ఉపయోగించండి.