డాక్యుమెంట్ ట్రాన్స్లేషన్ API యాక్సెస్ గైడ్: వర్డ్ మరియు పిడిఎఫ్లను అనువదించడానికి పైథాన్ని ఉపయోగించండి మరియు ఫలితాలను స్వీకరించడానికి వెబ్హూక్ని ఉపయోగించండి

డాక్యుమెంట్ ట్రాన్స్లేషన్ API స్ట్రింగ్ అప్లోడ్ చేయడం, టాస్క్లను సృష్టించడం, కాల్బ్యాక్లను స్వీకరించడం మరియు ఆటోమేటెడ్ ప్రాసెస్లోకి అనువాదాలను డౌన్లోడ్ చేయడం వంటివి చేయగలదు. మీరు కేవలం నాలుగు దశల్లో పూర్తి అనువాదాన్ని పూర్తి చేయవచ్చు.

మీ సిస్టమ్ ప్రతిరోజూ ఒప్పందాలు, సూచనలు, పేపర్లు లేదా నివేదికలను ప్రాసెస్ చేస్తే, మాన్యువల్ అప్లోడ్ చేయడం, వేచి ఉండటం మరియు డౌన్లోడ్ చేయడం త్వరగా అడ్డంకిగా మారుతుంది. ఈ దశలను ప్రోగ్రామ్కు అప్పగించడం ద్వారా మాత్రమే బ్యాచ్ ప్రాసెసింగ్ స్థిరంగా ఉంటుంది.

OmniDoc (Zhiyi) యొక్క డాక్యుమెంట్ ట్రాన్స్లేషన్ API మొత్తం ప్రక్రియను కలిపి ఉంచుతుంది: ఫైళ్లను అప్లోడ్ చేయండి, టాస్క్లను సృష్టించండి, పూర్తి నోటిఫికేషన్లను స్వీకరించండి మరియు అనువాదాలను డౌన్లోడ్ చేయండి. అనువాదం అసలు పత్రం యొక్క లేఅవుట్, పట్టికలు, చిత్రాలు మరియు సూత్రాలను కలిగి ఉంటుంది మరియు ద్విభాషా పోలికలను లేదా అనువాదాన్ని మాత్రమే అవుట్పుట్ చేయగలదు.

డాక్యుమెంట్ అనువాదాన్ని వారి స్వంత సిస్టమ్లలోకి చేర్చాల్సిన డెవలపర్లకు ఈ కథనం అనుకూలంగా ఉంటుంది. చదివిన తర్వాత, మీరు పూర్తి కాలింగ్ ప్రక్రియ, సాధారణ పారామీటర్లు, ఐడెమ్పోటెంట్ రీట్రీ మెథడ్స్, వెబ్హూక్ కాల్బ్యాక్లు మరియు బిల్లింగ్ నియమాలపై పట్టు సాధించగలరు మరియు పైథాన్ని ఉపయోగించి పూర్తి టాస్క్ను అమలు చేయగలరు.

డాక్యుమెంట్ అనువాద APIని ఎలా యాక్సెస్ చేయాలి? ఒక వాక్యం ముగింపు

మీరు నాలుగు-దశల ప్రక్రియలో స్వయంచాలకంగా అప్లోడ్ చేయడానికి, టాస్క్లను సృష్టించడానికి, కాల్బ్యాక్లను స్వీకరించడానికి మరియు అనువాదాలను డౌన్లోడ్ చేయడానికి APIని ఉపయోగించడం ద్వారా మీ స్వంత సిస్టమ్లో డాక్యుమెంట్ అనువాదాన్ని ఏకీకృతం చేయవచ్చు.

టేబుల్ 0 దృశ్యాలు మరియు సిఫార్సు చేసిన అభ్యాసాలను యాక్సెస్ చేయండి

యాక్సెస్ చేయడానికి ముందు ప్రాథమిక సమాచారాన్ని చదవండి

API యొక్క ప్రాథమిక సమావేశాలు క్రింది విధంగా ఉన్నాయి. కోడ్ రాయడం ప్రారంభించే ముందు ఈ విషయాలను నిర్ధారించండి.

టేబుల్ 1 API ప్రాథమిక సమావేశాలు

ఏ ఫైల్లకు మద్దతు ఉంది?

Word (.docx), Excel (.xlsx), PowerPoint (.pptx), PDF, HTML, EPUB, టెక్స్ట్తో మార్క్డౌన్, SRT/ASS ఉపశీర్షికలు, CSV, PNG/JPG చిత్రాలు మరియు UniDoc డాక్యుమెంట్లు (.udoc)కి మద్దతు ఇస్తుంది.

PPTX మినహా, అన్ని ఇతర ఫార్మాట్లు ద్విభాషా అవుట్పుట్కు మద్దతు ఇస్తాయి. PPTX ద్విభాషావాదాన్ని అభ్యర్థించినప్పుడు, అనువాదం మాత్రమే తిరిగి ఇవ్వబడుతుంది. నిర్దిష్ట పోలిక పద్ధతుల కోసం, దిగువ ప్రధాన పోలికను చూడండి.

నాలుగు దశల్లో అనువాదాన్ని పూర్తి చేయండి

1. అప్లోడ్ కోసం దరఖాస్తు చేసుకోండి: POST/upload/presignకి కాల్ చేయండి, ఫైల్ పేరు మరియు పరిమాణాన్ని సమర్పించండి మరియు ప్రత్యక్ష బదిలీ చిరునామా, అప్లోడ్ హెడర్ మరియు ఫైనల్_టోకెన్ను పొందండి.
2. అప్లోడ్ చేసి నిర్ధారించండి: ఫైల్ను ఉంచడానికి తిరిగి వచ్చిన అప్లోడ్ హెడర్ని ఉపయోగించండి మరియు అప్లోడ్ చేస్తున్నప్పుడు API కీని తీసుకురావద్దు. ఆపై document.idకి బదులుగా POST/upload/finalizeకి కాల్ చేయండి.
3. టాస్క్ని సృష్టించండి: POST /jobsకి కాల్ చేయండి, document_id మరియు target_langని సమర్పించండి మరియు అదే సమయంలో Idempotency-Keyని తీసుకురావాలని సిఫార్సు చేయబడింది.
4. ఫలితాలను తిరిగి పొందండి: పోల్ GET /jobs/{id}, లేదా SSE పురోగతికి సభ్యత్వం పొందండి లేదా Webhookని కాన్ఫిగర్ చేయండి. పని పూర్తయిన తర్వాత, ఉత్పత్తిని పొందేందుకు మరియు దానిని డౌన్లోడ్ చేయడానికి GET / artifacts?job_id=... ఉపయోగించండి.

టాస్క్లను సృష్టించడానికి సాధారణ పారామితులు

టాస్క్ను సృష్టించేటప్పుడు, డాక్యుమెంట్_ఐడి మరియు టార్గెట్_లాంగ్ అనే రెండు సాధారణంగా ఉపయోగించే ఫీల్డ్లు. ఇతర ఫీల్డ్లు అవసరమైన విధంగా సెట్ చేయబడ్డాయి.

టేబుల్ 2 POST /ఉద్యోగాల అభ్యర్థన ఫీల్డ్లు

పైథాన్ ఉదాహరణ: ఒక పనిని సృష్టించి, పూర్తయ్యే వరకు వేచి ఉండండి

దిగువ స్నిప్పెట్ అభ్యర్థనలపై మాత్రమే ఆధారపడి ఉంటుంది. పూర్తి అప్లోడ్ మరియు డౌన్లోడ్ ప్రక్రియ కోసం, దయచేసి డెవలపర్ డాక్యుమెంటేషన్ యొక్క పైథాన్ పేజీని చూడండి.

import time, uuid, requests

BASE = "https://omnidoc.top/api/v1"
HEADERS = {"X-API-Key": "sk_your_key"}

def create_job(document_id, target_lang="en", engine="xr-397b"):
    r = requests.post(f"{BASE}/jobs",
        headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
        json={"document_id": document_id, "target_lang": target_lang, "engine": engine},
        timeout=30)
    r.raise_for_status()
    return r.json()

def wait_for_job(job_id):
    while True:
        job = requests.get(f"{BASE}/jobs/{job_id}", headers=HEADERS, timeout=20).json()
        if job["status"] in ("completed", "failed"):
            return job
        time.sleep(5)

బ్యాచింగ్ మరియు మళ్లీ ప్రయత్నించడం: ఏకాభిప్రాయం, క్యూయింగ్ మరియు బలహీనత

ఆటోమేటిక్ క్యూయింగ్

ప్రతి ఖాతా ఏకకాలంలో 5 ఫైల్లను ప్రాసెస్ చేయగలదు. ఎగువ పరిమితిని మించిన టాస్క్లు క్రియేట్ చేయబడతాయి మరియు యధావిధిగా క్యూలో ఉంచబడతాయి మరియు స్టేజ్_మెసేజ్ ముందుకు ఎన్ని పనులు ఉన్నాయో తెలియజేస్తుంది.

Idempotent కీలు

Idempotency-Key ఒకేలా ఉంటే మరియు అభ్యర్థన అంశం ఒకేలా ఉంటే, అసలు టాస్క్ తిరిగి ఇవ్వబడుతుంది మరియు పదే పదే సృష్టించబడదు లేదా ఛార్జ్ చేయబడదు. నెట్వర్క్ గడువు ముగిసినప్పుడు, ముందుగా టాస్క్ స్థితిని తనిఖీ చేయండి మరియు కొత్త కీతో మళ్లీ సమర్పించవద్దు.

ఎర్రర్ కోడ్

• 403: ఎంచుకున్న కాన్ఫిగరేషన్ కీ కోసం అనుమతించబడదు.
• 404: డాక్యుమెంటేషన్ లేదా పదకోశం లేదు.
• 415: ఆకృతికి మద్దతు లేదు.
• 422: ఫైల్ ఖాళీగా ఉంది లేదా పారామీటర్లు చెల్లవు.

వెబ్హుక్: టాస్క్ ముగిసినప్పుడు మీ సర్వర్కు తెలియజేయండి

ప్రతి వినియోగదారు 3 వెబ్హుక్లను కాన్ఫిగర్ చేయవచ్చు. POST/webhooksతో సృష్టించండి, PATCHతో నవీకరించండి లేదా నిష్క్రియం చేయండి.

ఫైల్ అనువాద పని ముగిసినప్పుడు (విజయం లేదా వైఫల్యంతో సంబంధం లేకుండా), సిస్టమ్ job.completed ఈవెంట్ను పంపుతుంది:

• data.status పూర్తయింది లేదా విఫలమైంది.
• data.char_count అనేది అనువాద అక్షరాల సంఖ్య.

Webhookని సృష్టించేటప్పుడు రహస్యాన్ని పూరించండి మరియు ప్రతి తదుపరి కాల్బ్యాక్ X-Webhook-సిగ్నేచర్ని తీసుకువస్తుంది. కాల్బ్యాక్ మూలాన్ని నిర్ధారించడానికి అసలు అభ్యర్థనపై సంతకం చేయడానికి HMAC-SHA256ని ఉపయోగించండి.

కాల్బ్యాక్ URL తప్పనిసరిగా పబ్లిక్ నెట్వర్క్ నుండి యాక్సెస్ చేయబడాలి మరియు HTTPS సిఫార్సు చేయబడింది.

ఫీజును ఎలా లెక్కించాలి?

ప్రారంభించే ముందు బ్యాలెన్స్ చెక్ చేయండి

• PDF: బ్యాలెన్స్ "పేజీల సంఖ్య × 2 పాయింట్లు" కంటే ఎక్కువగా ఉండాలి.
• ఇతర ఫార్మాట్లు: అసలు పదాల సంఖ్య, కనీసం 2 పాయింట్ల ఆధారంగా ఛార్జ్ చేయబడుతుంది.
• బ్యాలెన్స్ సరిపోనప్పుడు, టాస్క్ కోటా_ఎక్స్సీడెడ్తో ముగుస్తుంది మరియు రుసుములు తీసివేయబడవు.

వాస్తవ వినియోగం ఆధారంగా తగ్గింపు

పని పూర్తయిన తర్వాత, వాస్తవ వినియోగం ఆధారంగా రుసుము తీసివేయబడుతుంది. పని విఫలమైతే లేదా రద్దు చేయబడితే, ఎటువంటి రుసుము తీసివేయబడదు.

ఉచిత ప్రశ్న

బ్యాలెన్స్, టాస్క్ స్థితి, వినియోగం, వోచర్లు మరియు డౌన్లోడ్ చిరునామాలను తనిఖీ చేయడం కోసం పాయింట్లు తీసివేయబడవు.

పాయింట్ల ప్యాకేజీ

పాయింట్ ప్యాకేజీలు 3,000 పాయింట్లకు ¥9.9 నుండి ప్రారంభమవుతాయి మరియు కొనుగోలు చేసిన పాయింట్లు చాలా కాలం పాటు చెల్లుబాటులో ఉంటాయి. అమ్మకానికి ఉన్న ప్యాకేజీలను GET/బిల్లింగ్/క్రెడిట్లు/ప్లాన్ల ద్వారా ప్రశ్నించవచ్చు.

తదుపరి దశ

పూర్తి కర్ల్, పైథాన్, Node.js ఉదాహరణలను డెవలపర్ డాక్యుమెంటేషన్లో చూడవచ్చు: https://docs.omnidoc.top/guide/quickstart/.

మీరు ప్రస్తుతానికి కోడ్ని వ్రాయకూడదనుకుంటే, స్థానిక ఫైల్లను నేరుగా అనువదించడానికి మీరు OmniDoc యొక్క AI అసిస్టెంట్కి కూడా కనెక్ట్ చేయవచ్చు. వివరాల కోసం, "AI నేరుగా Word, Excel మరియు PPTని ఆపరేట్ చేయనివ్వండి" చూడండి: https://omnidoc.top/blog/ai-word-excel-ppt-omnidoc/.

📊 కోర్ పోలిక

వేర్వేరు ఫైల్ ఫార్మాట్లు వేర్వేరు ద్విభాషా అవుట్పుట్ పద్ధతులను కలిగి ఉంటాయి. మీరు మీ స్వంత ఫైల్ రకం ప్రకారం ముందుగానే ప్లాన్ చేసుకోవచ్చు.

🎯 మీకు ఏ పద్ధతి అనుకూలంగా ఉంటుంది?

మీరు ప్రాసెస్ కాంట్రాక్ట్లు, స్పెసిఫికేషన్లు లేదా పేపర్లను బ్యాచ్ చేయాలనుకుంటే

సిస్టమ్కి కనెక్ట్ చేయడానికి మరియు స్వయంచాలకంగా అప్లోడ్ చేయడానికి, టాస్క్లను రూపొందించడానికి మరియు నాలుగు-దశల ప్రక్రియ ప్రకారం అనువాదాలను డౌన్లోడ్ చేయడానికి, మాన్యువల్ ఆపరేషన్లను తొలగించడానికి APIని ఉపయోగించండి.

మీ నెట్వర్క్ తరచుగా అస్థిరంగా ఉంటే

టాస్క్ను క్రియేట్ చేస్తున్నప్పుడు ఐడెంపోటెన్సీ-కీని తీసుకురండి. పునరావృత సృష్టి లేదా పునరావృత తగ్గింపులను నివారించడానికి గడువు ముగిసిన తర్వాత మొదట స్థితిని ప్రశ్నించండి.

మీరు పని ముగిసిన వెంటనే దాన్ని ప్రాసెస్ చేయాలనుకుంటే

Webhookని కాన్ఫిగర్ చేయండి మరియు సంతకం ధృవీకరణ కోసం రహస్యాన్ని పూరించండి. పని పూర్తయినప్పుడు సిస్టమ్ మీ సర్వర్కు ముందస్తుగా తెలియజేస్తుంది.

మీకు వృత్తిపరమైన పదజాలం కోసం ఏకీకృత అవసరాలు ఉంటే

బ్రాండ్ పేర్లు మరియు వృత్తిపరమైన పదాల అనువాదాన్ని ఏకీకృతం చేయడానికి టాస్క్ను సృష్టించేటప్పుడు ముందుగా గ్లాసరీని సృష్టించండి, ఆపై glossary_idలో పాస్ చేయండి.

❓ తరచుగా అడిగే ప్రశ్నలు (FAQ)

1. ఒకే పనిని పదేపదే సమర్పించినందుకు పదేపదే తగ్గింపులు ఉంటాయా?

ఐడెమ్పోటెన్సీ-కీ ఒకేలా ఉంటే మరియు అభ్యర్థన అంశం ఒకేలా ఉంటే, అసలు టాస్క్ పునరావృతం లేదా తగ్గింపు లేకుండా తిరిగి ఇవ్వబడుతుంది.

2. టాస్క్ విఫలమైతే లేదా రద్దు చేయబడితే, పాయింట్లు తీసివేయబడతాయా?

ఎటువంటి రుసుము వసూలు చేయబడదు. ఒక పని విఫలమైనప్పుడు లేదా రద్దు చేయబడినప్పుడు, ఎటువంటి తగ్గింపులు చేయబడవు.

3. తగినంత పాయింట్లు లేనప్పుడు ఏమి జరుగుతుంది?

టాస్క్ quota_exceededతో ముగుస్తుంది మరియు రుసుములు తీసివేయబడవు. ప్రారంభించడానికి ముందు బ్యాలెన్స్ థ్రెషోల్డ్: PDFకి "పేజీల సంఖ్య × 2 పాయింట్లు" కంటే ఎక్కువ బ్యాలెన్స్ అవసరం, మరియు ఇతర ఫార్మాట్లకు పద గణన ఆధారంగా కనీసం 2 పాయింట్ల బ్యాలెన్స్ అవసరం.

4. ఫైల్లను అప్లోడ్ చేస్తున్నప్పుడు నేను API కీని తీసుకురావాలా?

అనవసరమైన. అప్లోడ్ హెడర్ PUT ఫైల్ని ఉపయోగిస్తున్నప్పుడు, API కీని తీసుకురావద్దు.

5. నేను 429 ట్రాఫిక్ పరిమితిని ఎదుర్కొంటే నేను ఏమి చేయాలి?

ప్రతిస్పందనలో మళ్లీ ప్రయత్నించండి-తరువాత సమయం ప్రకారం మళ్లీ ప్రయత్నించండి.

📝 సారాంశం

అప్లోడ్లు, టాస్క్ క్రియేషన్, కాల్బ్యాక్లు మరియు డౌన్లోడ్లను ఆటోమేటెడ్ ప్రాసెస్లో స్ట్రింగ్ చేయడం ద్వారా, డాక్యుమెంట్ అనువాదాన్ని రోజువారీ వ్యాపారంలో విలీనం చేయవచ్చు. పైథాన్ ఉదాహరణతో ఒక పనిని అమలు చేయడం ద్వారా ప్రారంభించండి, ఆపై గ్లాసరీ, ద్విభాషా అవుట్పుట్ మరియు వెబ్హుక్స్లను అవసరమైన విధంగా జోడించండి.

ఇప్పుడే దీన్ని ప్రయత్నించండి: అనువాదాన్ని ప్రారంభించడానికి పత్రాన్ని అప్లోడ్ చేయండి, అసలు లేఅవుట్ను అలాగే ఉంచండి