यह पेज मशीन द्वारा अनुवादित है. मूल अंग्रेज़ी आर्टिकल देखें.

API उपयोग और लागत की समीक्षा करना

विश्लेषण में API गतिविधि देखें, API प्रतिक्रियाओं में टोकन की संख्या जाँचें और प्रोजेक्ट फ़िल्टर, निर्यात व स्केल टियर की लागत समझें.

अपडेट किया गया: 3 days ago

अवलोकन

आप API का उपयोग दो तरीकों से देख सकते हैं:

  • मौजूदा और पिछली रिपोर्टिंग अवधियों की API गतिविधि देखने के लिए विश्लेषण > उपयोग का इस्तेमाल करें.

  • किसी एक अनुरोध की जाँच करने के लिए API प्रतिक्रिया में उपयोग की जानकारी पढ़ें.

Playground उन्हीं API कॉल का इस्तेमाल करता है जिनका इस्तेमाल आपके एप्लिकेशन करते हैं. इसके टोकन आपके खाते के API उपयोग में गिने जाते हैं और उन पर उपयोग के वही नियम और कीमतें लागू होती हैं.

डैशबोर्ड का ऐक्सेस

उपयोग डैशबोर्ड को ऐक्सेस करने के लिए आपका संगठन का स्वामी होना या आपके पास उपयोग डैशबोर्ड की अनुमति होना ज़रूरी है.

डैशबोर्ड में उपयोग देखें

मौजूदा प्रोजेक्ट की समीक्षा करने के लिए, API प्लेटफ़ॉर्म में विश्लेषण खोलें और उपयोग चुनें. पूरे संगठन की रिपोर्टिंग के लिए, संगठन का विश्लेषण चुनें. जिस रिपोर्टिंग अवधि की समीक्षा करना चाहते हैं, उसे चुनें. प्रोजेक्ट और संगठन के विश्लेषण के बीच बदलने के बाद अवधि दोबारा जाँचें.

डैशबोर्ड का डेटा UTC में दिखाया जाता है. डैशबोर्ड की गतिविधि की तुलना अपने एप्लिकेशन लॉग से करते समय इस समय क्षेत्र का ध्यान रखें.

हाल का उपयोग डैशबोर्ड में दिखाई देने में समय लग सकता है. अगर हाल की गतिविधि नहीं दिख रही है, तो बाद में दोबारा जाँचें.

उपयोग को फ़िल्टर करें

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

API स्रोत, API कुंजियाँ, मॉडल, उपयोगकर्ता या प्रसंस्करण स्तर के आधार पर उपयोग को सीमित करने के लिए फ़िल्टर का इस्तेमाल करें. API स्रोत में आप सभी API स्रोत, एजेंट API या प्रत्यक्ष API चुन सकते हैं.

फ़िल्टर पैनल रीसेट करने के लिए चुने गए विकल्प एक-एक करके हटाएँ या फ़िल्टर हटाएँ चुनें. फ़िल्टर हटाने से प्रोजेक्ट और संगठन के विश्लेषण के बीच दृश्य नहीं बदलता.

बैच के आधार पर फ़िल्टर करने के लिए उपयोग चार्ट पर फ़िल्टर का इस्तेमाल करें. उस चार्ट के फ़िल्टर रीसेट करने के लिए चार्ट के फ़िल्टर रीसेट करें चुनें.

अगर किसी क्षमता पर चुने गए फ़िल्टर लागू नहीं होते, तो उसके मान उपलब्ध नहीं हो सकते हैं. मान उपलब्ध न होने का मतलब शून्य उपयोग नहीं है.

अगर किसी फ़िल्टर में अनुमति संबंधी त्रुटि दिखाई दे, तो हो सकता है कि आपको उसके विकल्पों तक पहुँच न मिली हो. इसका मतलब यह नहीं है कि कोई उपयोग दर्ज नहीं हुआ.

किसी एक उपयोगकर्ता का उपयोग देखें

  1. जिस प्रोजेक्ट या संगठन की समीक्षा करना चाहते हैं, उसके विश्लेषण दृश्य में उपयोग खोलें. API क्षमताएँ तालिका में, प्रतिक्रियाएँ और चैट कम्प्लीशन्स के लिए देखें चुनें.

  2. फ़िल्टर में, उपयोगकर्ता चुनें और फिर संबंधित उपयोगकर्ता चुनें. परिणाम तुरंत अपडेट हो जाते हैं.

  3. उस उपयोगकर्ता का चार्ट और तालिका देखें.

अलग-अलग क्षमताओं में किसी उपयोगकर्ता का उपयोग देखने के लिए, उपयोग के अवलोकन पर उपयोगकर्ता फ़िल्टर लागू करें. उपयोगकर्ताओं की तुलना करने के लिए, वह फ़िल्टर हटाएँ और तालिका में उपयोगकर्ता टैब चुनें.

प्रतिदिन, प्रति घंटे या प्रति मिनट के टोकन देखें

जहाँ उपयोग में अंतराल चुनने के विकल्प उपलब्ध हों, वहाँ दिन या घंटे के हिसाब से टोकन देखने के लिए 1 दिन या 1 घंटा चुनें, या प्रति मिनट टोकन (TPM) की जाँच करने के लिए 1 मिनट चुनें. डैशबोर्ड को आपकी रिपोर्टिंग अवधि के लिए समय अंतराल चुनने देने हेतु स्वचालित चुनें. ये अंतराल उपयोग के डेटा पर लागू होते हैं, बिलिंग के डेटा पर नहीं.

अगर 1 मिनट अक्षम है, तो छोटी रिपोर्टिंग अवधि चुनें या ज़ूम करने के लिए चुनें का इस्तेमाल करके चार्ट पर खींचें, ताकि समय-सीमा छोटी हो जाए. फिर 1 मिनट चुनें. ज़ूम के लिए किए गए चयन को रद्द करने हेतु Esc दबाएँ. दूसरी रिपोर्टिंग अवधि चुनने के लिए विश्लेषण टूलबार में मौजूदा तारीख-सीमा चुनें.

उपयोग के चार्ट और तालिकाएँ देखें

एक साथ दिखाने के लिए एक या अधिक डेटा शृंखलाएँ चुनने हेतु मापदंड का इस्तेमाल करें. इनमें इनपुट टोकन, कैश में न रखे गए इनपुट टोकन, कैश में रखे गए इनपुट टोकन, कैश में लिखे गए इनपुट टोकन, इनपुट ऑडियो टोकन, आउटपुट टोकन और आउटपुट ऑडियो टोकन शामिल हैं. उपलब्ध मापदंड क्षमता पर निर्भर करते हैं. हर डेटा शृंखला की पहचान करने के लिए संकेत-सूची का इस्तेमाल करें.

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

उपलब्ध श्रेणीवार विवरण देखने के लिए उपयोग तालिका के टैब का इस्तेमाल करें. तालिकाओं की हर पंक्ति में संबंधित माप दिखते हैं, जैसे अनुरोध, इनपुट और आउटपुट टोकन, या क्षमता-विशिष्ट इकाइयाँ.

API क्षमताएँ में किसी क्षमता के विस्तृत चार्ट और श्रेणीवार विवरण खोलने के लिए उसके सामने देखें चुनें. प्रतिक्रियाएँ और चैट कम्प्लीशन्स में टोकन और अनुरोध के अलग-अलग चार्ट और मॉडल अनुरोध मापदंड शामिल हैं. इसके श्रेणीवार विवरण वाले टैब में अवलोकन वाले ही आयाम इस्तेमाल होते हैं, लेकिन API क्षमताएँ टैब शामिल नहीं होता. अवलोकन पर लौटने के लिए नेविगेशन पथ में उपयोग पर जाएँ.

समूह बनाने का आधार का कोई विकल्प चुनने के बाद, चार्ट अतिरिक्त श्रेणियों को अन्य में मिला सकता है. अगर चार्ट की संकेत-सूची में अन्य दिखाई दे, तो उसमें शामिल श्रेणियाँ और उनके उपयोग के मान देखने के लिए उसका लेबल चुनें.

एक ही रिपोर्टिंग अवधि के लिए उपयोग को दूसरे डैशबोर्ड के साथ देखने हेतु डैशबोर्ड की तुलना करें चुनें. दृश्य चुनने के लिए बायाँ डैशबोर्ड और दायाँ डैशबोर्ड का इस्तेमाल करें. अगर चुना गया समय अंतराल दोनों डैशबोर्ड के लिए उपलब्ध नहीं है, तो दृश्य स्वचालित पर बदल जाता है. डैशबोर्ड पर लौटने के लिए तुलना से बाहर निकलें चुनें.

ऐसे उपयोग की जाँच करें जिसे आप पहचान नहीं पा रहे हैं

अगर उपयोग में ऐसी गतिविधि दिखती है जिसका मिलान आप अपने एप्लिकेशन लॉग में दर्ज अनुरोधों से नहीं कर पा रहे हैं, तो ये जाँच करें:

  1. संगठन, प्रोजेक्ट का दायरा और रिपोर्टिंग अवधि की पुष्टि करें. डैशबोर्ड के समय-चिह्नों की तुलना अपने एप्लिकेशन लॉग से करते समय UTC का इस्तेमाल करें.

  2. संबंधित प्रोजेक्ट के लिए प्रोजेक्ट दृश्य का इस्तेमाल करें या संगठन का विश्लेषण में प्रोजेक्ट के अंतर्गत उसे चुनें. फिर API कुंजी और मॉडल के आधार पर उपयोग को सीमित करने के लिए फ़िल्टर का इस्तेमाल करें और छोटी रिपोर्टिंग अवधि चुनें.

  3. गतिविधि की तुलना उसी अवधि, प्रोजेक्ट और API कुंजी के लॉग से करें. जाँचें कि आपके लॉग में उस कुंजी का इस्तेमाल करने वाले सभी एप्लिकेशन या एकीकरण शामिल हैं या नहीं.

  4. अगर कई एप्लिकेशन या एकीकरण एक ही प्रोजेक्ट या API कुंजी का इस्तेमाल करते हैं, तो केवल कुल उपयोग से यह पता नहीं चल सकता कि अनुरोध किसने भेजा था. डैशबोर्ड की तुलना हर एप्लिकेशन के उसी UTC अवधि के रिकॉर्ड से करें.

  5. अगर फिर भी आप उपयोग का कारण नहीं समझ पा रहे हैं, तो संबंधित UTC अवधि, संगठन और प्रोजेक्ट की आईडी, API कुंजी के पहचानकर्ता और संबंधित स्क्रीनशॉट या लॉग के साथ OpenAI सहायता से संपर्क करें. अनुरोध आईडी उपलब्ध हों, तो उन्हें शामिल करें. गोपनीय API कुंजियाँ शामिल न करें.

उपयोग का डेटा निर्यात करें

उपयोग का डेटा निर्यात करने के लिए, विश्लेषण टूलबार में CSV निर्यात करें आइकन चुनें, फिर गतिविधि का डेटा चुनें.

  1. API क्षमता चुनें और समूह बनाने का आधार के लिए एक या अधिक आयाम चुनें.

  2. API स्रोत, प्रोजेक्ट, उपयोगकर्ता, API कुंजियाँ और मॉडल की जाँच करें. प्रोजेक्ट और API स्रोत के विकल्प विश्लेषण के अनुसार पहले से चुने होते हैं; संवाद बॉक्स में निर्यात के अन्य फ़िल्टर चुनें.

  3. फ़ाइल का प्रारूप, शुरुआत का समय, समाप्ति का समय और समय अंतराल चुनें, फिर डाउनलोड करें चुनें. तारीखों में UTC के अनुसार पूरे दिन शामिल होते हैं.

एक कैलेंडर वर्ष पहले की तारीख को 00:00 UTC से लेकर आज तक का गतिविधि और लागत डेटा देखने और निर्यात करने के लिए उपलब्ध है. पुराने डेटा के लिए, OpenAI सहायता से संपर्क करें. दैनिक डेटा 31-31 दिनों की अवधि वाली फ़ाइलों में निर्यात होता है.

मासिक बिल का मिलान करने और मदवार विवरण निर्यात करने के लिए देखें: मासिक उपयोग का विवरण निर्यात करना.

अगर गतिविधि डेटा के निर्यात में ऋणात्मक मान वाली पंक्तियाँ शामिल हों, तो समान इकाई, समूहीकरण और तारीखों वाली पंक्तियों की तुलना करें. बिल की गई रकम के लिए लागत का डेटा इस्तेमाल करें. गतिविधि की किसी पंक्ति में ऋणात्मक मान होने से ही यह साबित नहीं होता कि आपके बिल में रकम वापस समायोजित की गई है.

खर्च देखें

मौजूदा प्रोजेक्ट की लागत देखने के लिए विश्लेषण खोलें और खर्च चुनें. पूरे संगठन की लागत देखने के लिए संगठन का विश्लेषण चुनें, फिर खर्च चुनें.

लागत की तुलना उपयोग से करने से पहले मौजूदा तारीख-सीमा और फ़िल्टर जाँचें. उपयोग और खर्च में अलग-अलग फ़िल्टर मिलते हैं; एक डैशबोर्ड में उपलब्ध फ़िल्टर दूसरे पर लागू नहीं भी हो सकता है.

खर्च का दायरा सीमित करने के लिए API स्रोत, API कुंजियाँ, मॉडल और मदें का इस्तेमाल करें. संगठन के विश्लेषण में, वे प्रोजेक्ट शामिल करने के लिए प्रोजेक्ट का इस्तेमाल करें जिनकी आप समीक्षा करना चाहते हैं. उपलब्ध श्रेणीवार विवरण के लिए तालिका में मदें, API कुंजियाँ, उपयोगकर्ता, प्रोजेक्ट और मॉडल टैब का इस्तेमाल करें.

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

सेवा की स्थिति देखें

अगर आपके संगठन को सेवा की स्थिति तक पहुँच मिली हुई है, तो API का प्रदर्शन देखने के लिए विश्लेषण में वह डैशबोर्ड खोलें. पात्रता और मापदंडों की परिभाषाओं के लिए देखें: API की त्रुटियों और विलंब की समस्याएँ हल करना.

दिए गए क्रेडिट्स देखें

दिए गए क्रेडिट्स का विवरण आपके संगठन के बिलिंग पेज पर उपलब्ध है.

दिए गए क्रेडिट्स और API उपयोग से अलग-अलग जानकारी मिलती है: पहले में आपके संगठन से जुड़े क्रेडिट्स दिखते हैं, जबकि उपयोग में उसकी API गतिविधि दिखती है.

स्केल टियर के उपयोग और लागत की समीक्षा करें

अगर आपके संगठन में स्केल टियर चालू है और आपके पास आवश्यक ऐक्सेस है, तो विस्तृत उपयोग देखने के लिए स्केल टियर उपयोग पेज खोलें.

स्केल टियर बंडल की लागत अलग-अलग प्रोजेक्ट के बजाय संगठन से जोड़ी जाती है.

उपयोग शून्य से अधिक है, लेकिन प्रोजेक्ट का खर्च शून्य है

जाँचें कि मॉडल का उपयोग आपके स्केल टियर आवंटन में शामिल है या नहीं. अगर उस मॉडल का पूरा उपयोग स्केल टियर के TPM आवंटन के भीतर है, तो प्रोजेक्ट में मॉडल पर अतिरिक्त खर्च के बिना उपयोग दिखाई दे सकता है.

स्केल टियर की सदस्यता का खर्च संगठन स्तर पर ही रहता है. किसी एक प्रोजेक्ट के खर्च पर निर्भर रहने के बजाय पूरे संगठन का खर्च देखें.

कई संगठनों की समीक्षा करें

उपयोग डैशबोर्ड अलग-अलग संगठनों की लागत या उपयोग के डेटा को एक साथ नहीं जोड़ता. हर संगठन को अलग माना जाता है, चाहे वह उप-संगठन ही क्यों न हो.

किसी उप-संगठन को देखने के लिए, संगठन चयनकर्ता में उसे चुनें.

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

API प्रतिक्रिया में टोकन का उपयोग जाँचें

टोकन के उपयोग से जुड़े फ़ील्ड के नाम एंडपॉइंट पर निर्भर करते हैं.

टोकन की संख्याचैट कम्प्लीशन्सप्रतिक्रियाएँ
इनपुट टोकनusage.prompt_tokensusage.input_tokens
आउटपुट टोकनusage.completion_tokensusage.output_tokens
कुल टोकनusage.total_tokensusage.total_tokens

चैट कम्प्लीशन्स की प्रतिक्रियाओं में टोकन के उपयोग की जानकारी शामिल हो सकती है. उदाहरणों में शामिल हैं:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

एंडपॉइंट और मॉडल के आधार पर, उपयोग विवरण में कैश किए गए इनपुट और रीज़निंग टोकन की संख्या भी शामिल हो सकती है. इनसे यह समझने में मदद मिलती है कि उत्तर की दिखाई देने वाली लंबाई से उसके कुल टोकन उपयोग का पता क्यों नहीं चलता.

टोकन की अलग-अलग श्रेणियों के बारे में जानने के लिए देखें: टोकन को समझना और उनकी गिनती करना.

टोकन उपयोग बताने वाले किसी लिप्यंतरण उत्तर में, ऑडियो और टेक्स्ट इनपुट टोकन पहले से ही input_tokens में शामिल होते हैं. इन घटकों को कुल इनपुट में दोबारा न जोड़ें. output_tokens की तुलना अलग से करें.

स्ट्रीम किए गए चैट कम्प्लीशन्स से उपयोग की जानकारी प्राप्त करें

स्ट्रीमिंग चैट कम्प्लीशन्स अनुरोध में यह शामिल करें:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

include_usage सक्षम होने पर, data: [DONE] से पहले आने वाले एक अतिरिक्त खंड में पूरे अनुरोध के उपयोग की जानकारी होती है. इसका choices ऐरे खाली होता है. अन्य खंडों में usage का मान null होता है.

अगर स्ट्रीम बाधित हो जाती है, तो हो सकता है कि आपको उपयोग की जानकारी वाला वह अंतिम खंड न मिले. अंतिम खंड न मिलने से यह साबित नहीं होता कि अनुरोध में किसी टोकन का उपयोग नहीं हुआ.

यह कॉन्फ़िगरेशन केवल चैट कम्प्लीशन्स के लिए है. विवरण के लिए देखें: चैट कम्प्लीशन्स API संदर्भ.

क्या यह लेख मददगार था?