跳转到内容

क्रेडिट आणि वापर

बिल करण्यायोग्य सेवांचा अकाउंट क्रेडिटमध्ये तडजोड केला जातो. रक्कम मिलीक्रेडिट्समध्ये दर्शवली जाते (millicredits); 1000 मिलीक्रेडिट्स 1 क्रेडिटच्या बरोबरीचे असतात. तुम्ही विनंत्यांमध्ये पाठवत असलेल्या रकमा पूर्णांक असाव्यात; शिल्लक आणि नोंदींमधील रकमा एक दशांश स्थान (0.1 मिलीक्रेडिट) धारण करू शकतात. प्रतिसादांमधील credit_precision हे 4 आहे, याचा अर्थ क्रेडिटमध्ये रूपांतरित केल्यावर जास्तीत जास्त 4 दशांश स्थान असते.

GET /api/v1/billing/credits/balance
Terminal window
curl https://omnidoc.top/api/v1/billing/credits/balance \
-H "X-API-Key: $OMNIDOC_API_KEY"

मुख्य फील्ड्स:

क्षेत्रअर्थ
availableकर्जानंतर आता उपलब्ध असलेले मिलीक्रेडिट्स; कर्ज असल्यास ऋणात्मक
debtमिलीक्रेडिट्समधील देणे: पूर्ण झालेल्या कामांच्या प्रत्यक्ष खर्चाचा तो भाग जो शिल्लक रकमेपेक्षा अधिक होतो. नंतर आलेले क्रेडिट्स (टॉप-अप्स, दैनिक अनुदान, रिडीम कोड्स, रिफंड्स इत्यादी) सर्वप्रथम ते देणे फेडतात.
spentएकूण मिलीक्रेडिट्स निकाली काढले
expiredज्या मिलीक्रेडिट्सची मुदत संपली होती किंवा जी काढून घेण्यात आली होती
today_chargedआज मिलीक्रेडिट्स निश्चित करण्यात आले
lotsक्रेडिट लॉट्स सध्या वैध आहेत आणि त्यांची मुदत संपणे
GET /api/v1/billing/credits/plans

एक सार्वजनिक एंडपॉइंट ज्यासाठी कोणतेही लॉगिन आवश्यक नाही आणि विक्रीसाठी उपलब्ध असलेले पॅक (purchase_plans, प्लॅन कोडद्वारे की-असलेले) परत करते. आता विक्रीसाठी उपलब्ध:

योजना कोडक्रेडिट्सकिंमतबोनस
credits_3000_v43,000¥9.90—
credits_10000_v410,000¥29.90—
credits_25000_v425,000¥698%
credits_50000_v4 (शिफारस केलेली)50,000¥12916%
credits_125000_v4125,000¥29925%
credits_450000_v4450,000¥99935%
  • “बोनस” ¥29.90 साठी 10,000 क्रेडिट्सच्या किंमतीवर गणना केली जाते आणि हे bonus_percent फील्ड आहे; शिफारस केलेल्या पॅकमध्ये recommended: true आहे. जेव्हा हे सेट केले जात नाही तेव्हा हे दोन्ही फील्ड दिसत नाहीत.
  • price_fen (फेनमध्ये, 1/100 युआन) ही किंमतासाठी आणि total_millicredits (मिलीक्रेडिट्स) हे क्रेडिट्ससाठी अधिकृत आहे. खरेदी केलेले क्रेडिट्स कधीही बंद होत नाहीत; पॅक पुन्हा खरेदी करता येतात आणि प्रत्येक वेळी एकाच वेळी मिळतात.
  1. काम सुरू होण्यापूर्वी शिल्लक एका थ्रेशोल्डच्या तुलनेत तपासली जाते : कामाच्या थ्रेशोल्डच्या वर शिल्लक (कर्जानंतर) असणे आवश्यक आहे, उदाहरणार्थ PDF अनुवादासाठी “पृष्ठ × 2 क्रेडिट्स”, इतर फाइल्ससाठी मूळ मजकूराची लांबी (कमीत कमी 2 क्रेडिट्स), आणि ऑडिओ, व्हिडिओ आणि स्पीचसाठी सर्व्हरने मोजलेल्या वेळ किंवा वर्णांवरून गणना केलेली किंमत (किंमती ऑडिओ, व्हिडिओ आणि आवाज ). बजेट असलेल्या API कीसह, कीचे उर्वरित बजेट देखील थ्रेशोल्डच्या वर असणे आवश्यक आहे. अन्यथा प्रतिसाद 402 असतो (एक फाइल अनुवाद काम quota_exceeded=true सह अयशस्वी होऊन संपते, एक मीडिया काम error_code=insufficient_credits सह संपते) आणि कोणतेही शुल्क आकारले जात नाही. काम सुरू केल्याने शिल्लक बदलत नाही.
  2. वास्तविक वापराचे शुल्क पूर्ण झाल्यावर आकारले जाते : फाइल अनुवाद (चित्रांसह), बॅच केलेला रिच टेक्स्ट, दस्तऐवज ऑपरेशन्स, ऑडिओ, व्हिडिओ आणि भाषण हे संपूर्ण वास्तविक वापरासाठी पूर्णतः शुल्क आकारले जातात. एका API कीचे बजेट केवळ सुरुवातीच्या तपासणीमध्येच वापरले जाते आणि पूर्ण झालेल्या कामाचे शुल्क कधीही कमी करत नाही; जर त्यामुळे कीचे वापरलेले बजेट मर्यादेपेक्षा जास्त झाले, तर मर्यादा वाढविण्यात येईपर्यंत ती की नवीन कामे सुरू करू शकत नाही. अयशस्वी किंवा रद्द केलेल्या कामांसाठी शुल्क आकारले जात नाही.
  3. शिल्लक ऋणात जाऊ शकते : प्रत्यक्ष खर्चाचा भाग जो शिल्लकेपेक्षा जास्त असतो, तो कर्ज म्हणून नोंदवला जातो आणि शिल्लक ऋणात दर्शवली जाते; नंतर येणारे क्रेडिट प्रथम कर्ज फेडतात. शिल्लक ऋणात असताना नवीन कामे सुरू होऊ शकत नाहीत; शिल्लक भरा.

ग्राहक कधीही “किती शुल्क आकारावे” हे सादर करत नाहीत; सर्व्हर जे वितरित केले गेले त्यावरून निश्चित झालेली रक्कम गणना करतो.

क्रिया आणि नोंदी

Section titled “क्रिया आणि नोंदी”
GET /api/v1/billing/credits/operations?limit=20
GET /api/v1/billing/credits/operations/{operation_id}
GET /api/v1/billing/credits/jobs/{job_id}

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

GET /api/v1/usage?limit=50
GET /api/v1/usage/summary

वापर अंत्यबिंदू खात्याची फाइल संख्या, वर्ण, टोकन्स आणि प्रक्रिया वेळ परत करतात.

क्वेरी मोफत आहेत

Section titled “क्वेरी मोफत आहेत”

शिल्लक, जॉब स्थिती, वापर, निकाल नोंदी, परिणाम सूची आणि डाउनलोड पत्ते तपासण्यासाठी कोणतेही क्रेडिट खर्च होत नाही.