इसे छोड़कर कंटेंट पर जाएं

क्रेडिट और उपयोग

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

शेष की जाँच करें

Section titled “शेष की जाँच करें”
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 (मिलीक्रेडिट्स) क्रेडिट के लिए। खरीदे गए क्रेडिट की समय-सीमा समाप्त नहीं होती; पैक फिर से खरीदे जा सकते हैं और हर बार एक ही बार में प्राप्त होते हैं।

चार्जिंग जीवनचक्र

Section titled “चार्जिंग जीवनचक्र”
  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 “क्वेरी मुफ़्त हैं”

बैलेंस, जॉब स्टेटस, उपयोग, सेटलमेंट रिकॉर्ड, परिणाम सूचियाँ और डाउनलोड पते की जाँच करने में कोई क्रेडिट खर्च नहीं होता।