跳转到内容

आपल्या अॅपमध्ये दस्तऐवज कार्यप्रवाह समाविष्ट करा

एक फाइल अपलोड करण्यापासून ते तिचे भाषांतर, प्रगती तपासणे आणि निकाल डाउनलोड करण्यापर्यंत. प्रत्येक चरण तुम्ही एकत्रित करत असलेल्या क्रमाने स्पष्ट केला जातो, ज्यामध्ये फाइल व्यवस्थापन, दस्तऐवज प्रक्रिया आणि ऑडिओ व व्हिडिओ सेवांसाठी प्रवेशबिंदू आहेत.

Base URL https://omnidoc.top/api/v1 · HTTPS · JSON · API की प्रमाणीकरण · फाइल अनुवाद असमांतर कार्य म्हणून चालतो

ही वेबसाइट HTTP क्लाउड API चे वर्णन करते.

01 कोणतेही क्रेडिट न खर्च करता एका विनंतीने सुरुवात करा

Section titled “01 कोणतेही क्रेडिट न खर्च करता एका विनंतीने सुरुवात करा”

फाइल्स अपलोड करण्यापूर्वी तुमची की आणि नेटवर्क कार्यरत आहे का हे पुष्टी करा. बॅलन्स चेक करण्यासाठी कोणतेही क्रेडिट लागत नाही आणि त्यामुळे कोणतीही भाषांतराची कामे तयार होत नाहीत.

  1. API की मिळवा

    API कंसोलमध्ये ला साइन इन करा आणि sk_ पासून सुरू होणारी की तयार करा. प्रत्येक अनुप्रयोगासाठी स्वतंत्र की वापरा आणि त्यास बजेट निश्चित करा.

    कीज ही त्या खात्यासाठी कार्य करते ज्याने ती तयार केली आहे. ती सर्व्हरवर ठेवा आणि एखाद्या वातावरण च biến्याबिल्टमधून वाचा; ती कधीही वेब पृष्ठाच्या स्रोतात किंवा सार्वजनिक रिपॉझिटरीमध्ये ठेवू नका.

  2. शिल्लक तपासा

    OMNIDOC_API_KEY हे पर्यावरण च biếnित्र सेट करा, त्यानंतर खालील उदाहरणांपैकी कोणतेही एक चालवा. यशस्वी असल्यास JSON परत केले जाईल; 401 याचा अर्थ आहे की कीची समस्या आहे आणि ती तपासण्याची गरज आहे. तिकिटे, स्क्रीनशॉट किंवा लॉगमध्ये कधीही संपूर्ण की दर्शवू नका.

    Terminal window
    export OMNIDOC_API_KEY="sk_your_key"
    curl --fail-with-body --silent --show-error \
    'https://omnidoc.top/api/v1/billing/credits/balance' \
    -H "X-API-Key: $OMNIDOC_API_KEY"

02 फाइलमधून अनुवादाकडे

Section titled “02 फाइलमधून अनुवादाकडे”

यशस्वी अपलोड म्हणजे केवळ फाइल संग्रहित झाली आहे. जॉब तयार केल्यानंतर, तो अंतिम स्थितीत पोहोचेपर्यंत प्रतीक्षा करा, त्यानंतर त्याचे निकाल सूचीबद्ध करा आणि डाउनलोड करा.

पायरीपद्धत आणि मार्गकाय ठेवायचे
अपलोडची विनंती कराPOST /upload/presignupload_url, upload_headers, finalize_token
फाइल पाठवाPUT परत केलेल्या upload_url वरयशस्वी प्रतिसाद; या विनंतीमध्ये कोणतीही API की नाही.
अपलोडची पुष्टी कराPOST /upload/finalizedocument.id
अनुवाद तयार कराPOST /jobsनोकरी id
स्थिती तपासाGET /jobs/{job_id}completed किंवा failed
निकालांची यादी कराGET /artifacts?job_id={job_id}कलाकृती आयडी आणि स्वरूपे
निकाल डाउनलोड कराGET /artifacts/{artifact_id}/downloadफाइल बाइट्स आणि प्रतिसाद फाइलचे नाव

थेट अपलोडसाठी, सर्व्हरकडून परत केलेल्या स्वरूपातच upload_headers पाठवा, आणि स्टोरेज पत्त्यावर कधीही X-API-Key पाठवू नका. जर अपलोड पत्ता कालबाह्य झाला किंवा हस्तांतरण अयशस्वी झाले, तर नवीन पत्ता मागवा. तपशील: अपलोड प्रोटोकॉल , क्विक स्टार्ट , संपूर्ण Node.js वर्कफ्लो आणि अनुवाद विनंती फील्ड्स .

03 तुमच्या कार्यासाठी अंतिम बिंदू शोधा

Section titled “03 तुमच्या कार्यासाठी अंतिम बिंदू शोधा”

प्रत्येक नोंदीमध्ये मार्ग, विनंती फील्ड्स आणि उदाहरणे सूचीबद्ध असतात. तुमच्या खात्याची सेवा स्थिती आणि तुमच्या कीची मर्यादा या सर्वांवर लागू होतात.

04 प्रमाणीकरण आणि संसाधन मालकी

Section titled “04 प्रमाणीकरण आणि संसाधन मालकी”

API की एक खात्याची ओळख पटवते. हा कोणत्याही फाइलसाठीचा सार्वजनिक डाउनलोड पासवर्ड नाही.

विनंती हेडर

X-API-Key: sk_… किंवा Authorization: Bearer sk_… वापरा, प्रत्येक विनंतीसाठी त्यापैकी एक. JSON बॉडीजसह Content-Type: application/json पाठवा.

एखादी किल्ली कोणत्या ठिकाणापर्यंत पोहोचू शकते

एक की फक्त त्या संसाधनांपर्यंत पोहोचते ज्याचा वापर त्याचे खाते करू शकते; सेवेची स्थिती, कीचे बजेट आणि परवानगी असलेली भाषांतर सेटिंग्ज अद्याप लागू होतात. खात्यातील बदल आणि की तयार करणे, फिरवणे किंवा रद्द करणे हे कंसोलमध्ये होते.

पहा प्रमाणीकरण, बजेट्स आणि रोटेशन आणि सेवा आणि परवानग्या .

05 एकत्रीकरणामध्ये बिल्ड अयशस्वीतेचे हाताळणे समाविष्ट करा

Section titled “05 एकत्रीकरणामध्ये बिल्ड अयशस्वीतेचे हाताळणे समाविष्ट करा”

टाइमआउट म्हणजे जॉब तयार झाला नाही असे नाही. दुरुस्त कराव्या लागणाऱ्या विनंत्यांपासून पुनर्प्रयत्नयोग्य त्रुटींचे भेद करा, जेणेकरून कोणतीही गोष्ट दोनदा सबमिट किंवा प्रक्रिया केली जाणार नाही.

  • Idempotent creation : प्रत्येक नवीन तयार करण्याच्या ऑपरेशनसाठी Idempotency-Key जनरेट करा; जेव्हा तुम्ही तीच ऑपरेशन पुन्हा प्रयत्न करता, तेव्हा मूळ की आणि अगदी समान रिक्वेस्ट बॉडी पुन्हा वापरा. कागदपत्र ऑपरेशन्स, मीडिया जॉब्स आणि व्हॉइस तयारीसाठी ही की आवश्यक आहे; इतर तयार करण्याच्या एंडपॉईंट्ससाठी त्यांच्या संदर्भ पृष्ठे पहा.
  • असमान्य सूचना : पहिल्या एकत्रीकरणासाठी पोलिंग ठीक आहे; सतत प्रगतीसाठी SSE वापरा, आणि पृष्ठभूमीवर अंतिम स्थिती मिळवण्यासाठी webhook चा वापर करा.
स्थितीआधी तपासाकाय करावे
401 / 403की, परवाने, संसाधन मालकी凭据 किंवा परवानग्या दुरुस्त करा; अंधानुभूतीने पुन्हा प्रयत्न करू नका
402उपलब्ध क्रेडिटरिचार्ज करा, त्यानंतर पुन्हा सबमिट करा
409इडेम्पोटन्सी की आणि बॉडी, संसाधन स्थितीनवीन ऑपरेशन सुरू करण्यापूर्वी मूळ ऑपरेशनची चौकशी करा
422प्रतिसादातील क्षेत्र त्रुट्यापॅरामीटर्स किंवा फाइल ठीक करा
429व्यवसाय code आणि Retry-Afterदर आणि कतार मर्यादा पूर्ण होईपर्यंत प्रतीक्षा केली जाऊ शकते; वापरलेले की बजेट प्रथम वाढवावे लागेल
5xxतात्पुरती सेवा त्रुटीमर्यादित एक्सपोनेंशियल बॅकऑफ; create विनंत्यांसाठी idempotency की ठेवा

X-Request-Id रिस्पॉन्स हेडर, विनंतीची वेळ आणि मार्ग तपासणीसाठी ठेवा; पूर्ण की कधीही लॉग करू नका. सर्व त्रुटी कोड आणि पुन्हा प्रयत्नांची उदाहरणे error reference मध्ये आहेत.

06 एकत्रित करण्यापूर्वी बिलिंग कशी कार्य करते हे तपासा

Section titled “06 एकत्रित करण्यापूर्वी बिलिंग कशी कार्य करते हे तपासा”

क्रेडिट नाहीत

अपलोड करणे, जॉब्स तपासणे, परिणाम डाउनलोड करणे आणि बॅलन्स आणि सेटलमेंट रेकॉर्ड्स वाचणे यांसाठी क्रेडिट लागत नाही; ग्लॉसरी, प्रोजेक्ट्स, टॅग्स, सर्च आणि शेअरिंग यांसाठीही क्रेडिट लागत नाही.

वापरानुसार आकारणी केली जाते

फाइल अनुवाद, दस्तऐवज साधने, तत्काळ अनुवाद आणि ऑडिओ व व्हिडिओ सेवा यांची किंमत प्रत्यक्ष वापरानुसार ठरवली जाते; एखादी कार्य तयार करणे ही अंतिम शुल्क नाही.

काम सुरू होण्यापूर्वी, फक्त शिल्लक जादा मर्यादा तपासली जाते; काम पूर्ण झाल्यानंतर प्रत्यक्ष वापराचे शुल्क आकारले जाते. जर शिल्लक पुरेसे नसेल, तर तफावत कर्ज म्हणून नोंदवली जाते आणि नंतर आलेल्या क्रेडिटमधून ते प्रथम भरले जाते. आपण प्रति काम किंवा प्रति क्रेडिट ऑपरेशननुसार शुल्क आणि परताव्याचे समन्वय करू शकता. एखाद्या कीचे बजेट संपल्यावरही, आपण त्या की अंतर्गत असलेल्या कामे, परिणाम आणि नोंदी विचारू शकता.