दस्तावेज़ अनुवाद API

node --env-file=.env translate-text.mjs input.txt Spanish translated.txt
node --env-file=.env translate-text.mjs input.txt Spanish translated.txt --start

POST /api/v1/quotes
Authorization: Bearer doctr_...
Content-Type: application/json

{
  "version": "document-ir/7",
  "format": "txt",
  "fingerprint": "f8c3bf62a9aa3e6fc1619c250e48abe7519373d3edf41be62eb5dc45199af2ef",
  "sourceLanguage": "auto",
  "targetLanguage": "Spanish",
  "segments": [
    {
      "id": "s0",
      "text": "Hello, world."
    }
  ]
}

POST /api/v1/quotes?output=best-effort-v1

POST /api/v1/translations
Authorization: Bearer doctr_...
Content-Type: application/json

{
  "quoteId": "<quote id>",
  "idempotencyKey": "my-document-0001",
  "payload": {
    "version": "document-ir/7",
    "format": "txt",
    "fingerprint": "f8c3bf62a9aa3e6fc1619c250e48abe7519373d3edf41be62eb5dc45199af2ef",
    "sourceLanguage": "auto",
    "targetLanguage": "Spanish",
    "segments": [
      {
        "id": "s0",
        "text": "Hello, world."
      }
    ]
  }
}

GET /api/v1/translations/JOB_ID/result
Authorization: Bearer doctr_...

{
  "version": "document-ir/7",
  "jobId": "<job id>",
  "fingerprint": "f8c3bf62a9aa3e6fc1619c250e48abe7519373d3edf41be62eb5dc45199af2ef",
  "targetLanguage": "Spanish",
  "segments": [
    {
      "id": "s0",
      "text": "Hola, mundo."
    }
  ],
  "mock": false
}

cURL के साथ एक अनुरोध

ऊपर दिए गए कोटेशन JSON को payload.json के रूप में सेव करें और अपने शेल में DOCUMENT_TRANSLATOR_API_KEY सेट करें। यह कमांड केवल कोटेशन का अनुरोध करता है। शुरू करने के लिए, लौटाई गई quote ID और वही payload लेकर start JSON को translations endpoint पर भेजें।

curl https://document-translator.com/api/v1/quotes \
  -H "Authorization: Bearer $DOCUMENT_TRANSLATOR_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @payload.json

PowerShell में, curl.exe और $env:DOCUMENT_TRANSLATOR_API_KEY का उपयोग करें; ऊपर दिखाए गए बैकस्लैश वाले निरंतरता प्रारूप के बजाय कमांड एक ही पंक्ति में लिखें।

अनुवाद क्रेडिट और API कुंजियाँ

सीमाओं के भीतर हर API दस्तावेज़ के लिए खाते का एक क्रेडिट आरक्षित होता है। सख्त जॉब में शुल्क तभी लगता है जब परिणाम की पुष्टि हो जाए और वह तैयार हो। अधूरे असफल या रद्द किए गए जॉब का आरक्षण छोड़ दिया जाता है। बेस्ट-एफ़र्ट आउटपुट में छोटी कमियों के लिए सहमत क्रेडिट इस्तेमाल हो सकता है, जबकि बड़ी कमियों या गंभीर त्रुटियों पर क्रेडिट छोड़ दिया जाता है। यह मानने के बजाय कि हर तैयार परिणाम का शुल्क लिया गया है, outcome.creditOutcome और outcome.completion देखें।

हर खाते के लिए अधिकतम पाँच सक्रिय API कुंजियाँ बनाएँ। कुंजियाँ केवल एक बार दिखाई जाती हैं, हैश के रूप में संग्रहीत होती हैं और खाते में रद्द की जा सकती हैं। एक सक्रिय कुंजी उस खाते के सशुल्क अनुवादों तक पहुँच सकती है, जिनमें उसी खाते की किसी दूसरी कुंजी से बनाए गए कार्य भी शामिल हैं। कुंजियाँ साइन इन या भुगतान की अनुमति नहीं देतीं।

दोबारा कोशिशें और बीच में रुके अनुरोध

GET /api/v1/translations?requestKey=IDEMPOTENCY_KEY&quoteId=QUOTE_ID
DELETE /api/v1/translations?requestKey=IDEMPOTENCY_KEY&quoteId=QUOTE_ID

अनिश्चित शुरुआत अनुरोध के बाद उसी quote ID, payload और idempotency key का फिर से उपयोग करें। समान दोबारा कोशिशें बिना कोई अतिरिक्त शुल्क लिए मौजूदा जॉब लौटाती हैं। बदला हुआ payload या किसी दूसरी quote के लिए दोबारा उपयोग की गई key, 409 लौटाती है। जॉब और idempotency का मेटाडेटा समाप्ति के बाद सात दिनों तक रखा जाता है।

जब तक स्रोत टेक्स्ट उपलब्ध है, तब तक विफल हुए ऐसे जॉब को फिर से चलाया जा सकता है जिसे बीच में रोककर बाद में जारी किया जा सके। दोबारा चलाने पर उसका जॉब ID वही रहेगा और पहले से पूरे हुए हिस्सों का फिर उपयोग होगा। प्रत्येक जॉब को अधिकतम तीन बार प्रोसेस किया जा सकता है। अनुवाद दोबारा शुरू किए बिना, डाउनलोड विफल होने पर परिणाम वाले एंडपॉइंट पर फिर कोशिश की जा सकती है।

पोलिंग और डाउनलोड

GET /api/v1/translations/JOB_ID
GET /api/v1/translations?ids=JOB_ID_1,JOB_ID_2
GET /api/v1/translations/JOB_ID/result
PUT /api/v1/translations/JOB_ID/files/txt
GET /api/v1/translations/JOB_ID/files/txt
POST /api/v1/translations/JOB_ID/retry
DELETE /api/v1/translations/JOB_ID

बैच स्थिति अनुरोध में अधिकतम 100 ID स्वीकार करता है और केवल अधिकृत, हटाए न गए जॉब वाली { jobs: [...] } सूची लौटाता है। प्रोसेसिंग के दौरान लगभग हर पाँच सेकंड में और कतार में रहने के दौरान हर पंद्रह सेकंड में स्थिति जाँचें। 100 से अधिक जॉब फिर से प्राप्त करते समय बैचों को बारी-बारी से निष्पक्ष रूप से चुनें। छिपे हुए टैब में स्थिति जाँचना रोकें और अंतिम स्थिति या स्थायी प्राधिकरण त्रुटि आने पर बंद कर दें।

स्थिति तैयार होने पर, उसी खाते के प्राधिकरण से नतीजा प्राप्त करें। इसमें स्थानीय स्तर पर पुनर्निर्माण के लिए अनुवादित खंडों की मैपिंग शामिल होती है। नतीजे पूरे होने के बाद 24 घंटे तक उपलब्ध रहते हैं; असफल इनपुट, बनाए जाने के एक घंटे बाद समाप्त हो जाता है। समाप्त नतीजों पर 410 मिलता है। हटाए गए या पहुँच से बाहर जॉब पर 404 मिलता है।

queued → processing → ready
                   ↘ failed / cancelled / expired

{"jobs":[{"id":"<job id>","state":"processing","completedChunks":1,"totalChunks":2}]}

तैयार फ़ाइल को उसके बाइनरी बॉडी, Content-Length और उससे मेल खाते Content-Type के साथ PUT द्वारा सेव करें। समर्थित एक्सटेंशन हैं: docx, pptx, xlsx, pdf, txt और md। हर फ़ॉर्मैट के लिए एक फ़ाइल सेव की जा सकती है और आउटपुट की सीमा 50 MB है। सफल सेव को दोहराने पर मौजूदा फ़ाइल बनी रहती है। GET से सेव की गई फ़ाइल डाउनलोड करें; जॉब की स्थिति में savedFormats उपलब्ध फ़ॉर्मैट दिखाता है। सेव और डाउनलोड पर जॉब के समान स्वामित्व-जाँच लागू होती है, इनके लिए अतिरिक्त क्रेडिट नहीं लगते और 24 घंटे की समय-सीमा नहीं बढ़ती।

PUT /api/v1/translations/{id}/files/docx
X-Download-Kind: reading-copy
Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Content-Length: {bytes}

{binary DOCX body}

GET /api/v1/translations/{id}

{"savedFormats":["docx"],"savedDownloads":[{"format":"docx","kind":"reading-copy"}]}

DELETE अधूरे काम को रद्द करता है या उपलब्ध टेक्स्ट और सहेजी गई फ़ाइलें हटाता है। पूरा हुआ परिणाम हटाने से क्रेडिट वापस नहीं मिलते और न ही डाउनलोड की अवधि बढ़ती है। इस रिलीज़ में काम पूरा होने के वेबहुक उपलब्ध नहीं हैं।

PUT /api/v1/translations/{id}/manifest
Content-Type: application/json
Content-Length: {bytes, maximum 2 MiB}

{"version":1,"parserVersion":"document-ir/7","fingerprint":"{original SHA-256}","ocr":[]}

PUT /api/v1/translations/{id}/source
Content-Type: application/octet-stream
Content-Length: {bytes, maximum 25 MiB}
X-Parser-Version: document-ir/7
X-Source-SHA256: {original SHA-256}

{unchanged original bytes}

GET /api/v1/translations/{id}
// sourceBackup is available only after both saves
GET /api/v1/translations/{id}/manifest
GET /api/v1/translations/{id}/source

खाते की शेष राशि और इतिहास

GET /api/v1/translations?before=NEXT_CURSOR&limit=5
GET /api/v1/translations?active=1&before=NEXT_CURSOR
GET /api/account/balance

इतिहास केवल मौजूदा खाते के लिए उपलब्ध है और लौटाए गए पेजिनेशन कर्सर का उपयोग करता है। बैलेंस एंडपॉइंट ब्राउज़र खाते के सत्र का उपयोग करता है और साइन-इन तथा बैलेंस की न्यूनतम जानकारी लौटाता है। Checkout लंबित होने पर, इसे हर पाँच सेकंड में अधिकतम दस बार जाँचें, पेज छिपा होने पर रोकें और क्रेडिट मिलने या खाते से साइन आउट होने पर बंद कर दें।

n8n, Make और Zapier

गुप्त Bearer क्रेडेंशियल के साथ HTTP अनुरोध वाला चरण इस्तेमाल करें। पहले टेक्स्ट निकालें, JSON पेलोड को कोट एंडपॉइंट पर POST करें, फिर कोट ID, पेलोड और 16–80 अक्षरों वाली स्थिर idempotency key को translations एंडपॉइंट पर POST करें। विलंब जोड़ें और तैयार होने तक स्थिति के लिए GET करें, फिर नतीजा प्राप्त करके अनुवादित टेक्स्ट को दोबारा बनाएँ या सेव करें। कोट ID और रीट्राई कुंजी को अपने वर्कफ़्लो रिकॉर्ड के साथ सेव करें। किसी विशेष कनेक्टर या multipart अपलोड की ज़रूरत नहीं है।

सीमाएँ और त्रुटियाँ

• हर दस्तावेज़ में अधिकतम 50,000 स्रोत शब्द, निकाले गए 400,000 अक्षर और 12,000 टेक्स्ट सेगमेंट हो सकते हैं। ब्राउज़र में मूल फ़ाइलों की सीमा 25 MB, PDF की 300 पृष्ठ और PowerPoint फ़ाइलों की 300 स्लाइड है। ये स्रोत की सीमाएँ हैं और अनुवाद शुरू होने से पहले जाँची जाती हैं।
• हर खाते में अधिकतम 100 दस्तावेज़ कतार में या प्रोसेस हो सकते हैं। API कुंजियों के लिए प्रति मिनट 120 कोट और प्रति खाते हर दस सेकंड में पाँच नए अनुरोध या रीट्राई की सीमा है। 429 जवाबों में Retry-After का पालन करें और अस्थायी विफलताओं के लिए सीमित बैकऑफ़ का उपयोग करें; बार-बार स्थिति जाँचने से प्रोसेसिंग तेज़ नहीं होती।
• सख़्त आउटपुट में शुल्क लेने से पहले छूटे हुए, डुप्लिकेट या गलत फ़ॉर्मैट वाले अनूदित अंश अस्वीकार कर दिए जाते हैं। सर्वोत्तम-प्रयास आउटपुट में सत्यापित अनुवाद रखे जाते हैं और जिन अनुभागों का समाधान नहीं हुआ है, उनमें मूल टेक्स्ट बना रह सकता है; परिणाम और समस्याएँ इसकी जानकारी देते हैं। दस्तावेज़ की सामग्री में कोई वॉटरमार्क या सेवा का श्रेय नहीं जोड़ा जाता।

त्रुटियों में एक त्रुटि संदेश और कोड शामिल होते हैं। 400 का अर्थ है अमान्य इनपुट, 401 का अर्थ है अमान्य प्राधिकरण, 402 का अर्थ है अपर्याप्त क्रेडिट, 404 का अर्थ है अनुपलब्ध जॉब, 409 का अर्थ है परस्पर विरोधी कोट या स्थिति, 410 का अर्थ है समय-सीमा समाप्त होना, 429 का अर्थ है दर या क्षमता की सीमा, और 503 का अर्थ है अनुपलब्ध सेवा।

अनुवाद शुरू होने के बाद, हम आपके मूल दस्तावेज़ और पुनर्निर्माण डेटा का निजी बैकअप अधिकतम 24 घंटे तक रखते हैं। पूरा मूल-फ़ॉर्मैट डाउनलोड सहेजे जाने या आपके अनुवाद हटाने के बाद बैकअप इससे पहले भी हटा दिए जाते हैं। फ़ाइलनाम और PDF पासवर्ड कभी अपलोड नहीं किए जाते। अनुवाद प्रदाता को केवल निकाला गया टेक्स्ट भेजा जाता है। OCR आपके ब्राउज़र में चलता है। गोपनीयता विवरण