बिलिंग फ़ोल्डर्स

Billing Folders workspace administrators को फ़ोल्डर स्तर पर billable usage को ट्रैक और प्रबंधित करने देती है।

के बारे में

Billing Folders एक प्रीमियम फ़ीचर है, जो Enterprise योजनाओं के लिए उपलब्ध है। अपने वर्कस्पेस के लिए Billing Folders सक्षम करने हेतु, संपर्क करें Roboflow बिक्री टीम या अपने खाता प्रतिनिधि से। उपलब्ध योजनाओं के बारे में अधिक जानकारी के लिए, देखें हमारा मूल्य निर्धारण पृष्ठ.

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

उपयोग आवंटन कैसे काम करता है

जब Billing Folders सक्षम होता है, तो आपके वर्कस्पेस के प्रत्येक फ़ोल्डर को अपनी अलग API कुंजी मिलती है। किसी फ़ोल्डर के प्रोजेक्ट्स के भीतर होने वाला सभी बिलयोग्य उपयोग उस फ़ोल्डर की API कुंजी के विरुद्ध ट्रैक किया जाता है। इसका मतलब है कि आप अपनी उपयोग रिपोर्टों और डैशबोर्ड में ठीक-ठीक देख सकते हैं कि प्रत्येक फ़ोल्डर कितना उपयोग कर रहा है।

उपयोग आवंटन अपने-आप होता है। आपको उपयोग को फ़ोल्डरों को मैन्युअल रूप से असाइन करने की आवश्यकता नहीं है। यह प्रोजेक्ट से उसके मूल फ़ोल्डर में प्रवाहित होता है।

API या परिनियोजन उपयोग

जब आप API कुंजी का उपयोग करके Roboflow सेवाओं का उपयोग करते हैं (जिसमें Serverless Cloud API, Batch Processing आदि शामिल हैं, लेकिन इन्हीं तक सीमित नहीं), तो बिलिंग आवंटन अनुरोध में मौजूद API कुंजी के अनुसार होता है, न कि प्रोजेक्ट के फ़ोल्डर के अनुसार।

वर्कस्पेस-स्तरीय API कुंजी के साथ किया गया अनुरोध वर्कस्पेस को आवंटित होता है, भले ही उपयोग किया गया मॉडल किसी फ़ोल्डर में मौजूद प्रोजेक्ट का हो। सीधे API या बैच उपयोग को किसी फ़ोल्डर को आवंटित करने के लिए, उस फ़ोल्डर की API कुंजी के साथ अनुरोध करें।

इमेज स्टोरेज आवंटन

इमेज स्टोरेज उस फ़ोल्डर को आवंटित होती है जिसमें उस इमेज को संदर्भित करने वाले प्रोजेक्ट(ों) शामिल हैं।

यदि कोई इमेज उसी फ़ोल्डर के भीतर कई प्रोजेक्ट्स में साझा की जाती है (या समान मूल के सबफ़ोल्डरों के भीतर), तो स्टोरेज उस सबसे गहरे फ़ोल्डर को आवंटित होती है जिसमें उस इमेज का उपयोग करने वाले सभी प्रोजेक्ट शामिल हों:

वर्कस्पेस
├── फ़ोल्डर A
│   ├── प्रोजेक्ट 1  ← image.jpg
│   └── प्रोजेक्ट 2  ← image.jpg (साझा)
└── फ़ोल्डर B
    └── प्रोजेक्ट 3

image.jpg स्टोरेज फ़ोल्डर A को आवंटित होती है (वह सबसे गहरा फ़ोल्डर जिसमें इसे संदर्भित करने वाले सभी प्रोजेक्ट शामिल हैं)

यदि कोई इमेज अलग-अलग रूट फ़ोल्डरों के प्रोजेक्ट्स में बिना किसी सामान्य मूल फ़ोल्डर के साझा की जाती है, तो स्टोरेज वर्कस्पेस स्तर पर आवंटित होती है:

वर्कस्पेस
├── फ़ोल्डर A
│   └── प्रोजेक्ट 1  ← image.jpg
└── फ़ोल्डर B
    └── प्रोजेक्ट 2  ← image.jpg (साझा)

image.jpg स्टोरेज वर्कस्पेस को आवंटित होती है (कोई एक फ़ोल्डर दोनों प्रोजेक्ट्स को शामिल नहीं करता)

फ़ोल्डर क्रिया मेनू

फ़ोल्डर नियंत्रण फ़ोल्डर के क्रिया मेनू (तीन-बिंदु आइकन) में होते हैं। आप इसे फ़ोल्डर सूची से या फ़ोल्डर के प्रोजेक्ट्स पेज के हेडर से, फ़ोल्डर नाम के बगल में, खोल सकते हैं। इसमें "Folder Usage", "Folder API Key", और "Set Permissions" शामिल हैं।

उपयोग देखना

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

किसी एक फ़ोल्डर का उपयोग सीधे देखने के लिए, उस फ़ोल्डर के क्रिया मेनू से "Folder Usage" चुनें।

फ़ोल्डर उपयोग को रोकना और फिर से शुरू करना

वर्कस्पेस प्रशासक किसी फ़ोल्डर के भीतर सभी बिलयोग्य उपयोग को अस्थायी रूप से रोक सकते हैं। यह लागत नियंत्रित करने या अनजाने उपयोग को रोकने के लिए उपयोगी है।

फ़ोल्डर को रोकना

किसी फ़ोल्डर को रोकने के लिए, फ़ोल्डर के क्रिया मेनू से "Folder API Key" चुनें, "Pause Folder Usage" टॉगल करें, फिर दिखाई देने वाले संदेश में पुष्टि करें।

जब किसी फ़ोल्डर को रोका जाता है:

• उस फ़ोल्डर से संबंधित सभी API कुंजियाँ निष्क्रिय कर दी जाती हैं

• उस फ़ोल्डर के विरुद्ध उपयोग उत्पन्न करने वाला कोई भी API अनुरोध अस्वीकार कर दिया जाता है और उसके साथ एक 423 Locked स्टेटस कोड

• फ़ोल्डर के लिए कोई नया बिलयोग्य उपयोग दर्ज नहीं किया जाता

आप "Pause All Descendant Folders' Usage" टॉगल करके एक फ़ोल्डर और उसके सभी अवतारी फ़ोल्डरों को एक साथ भी रोक सकते हैं। इससे चयनित फ़ोल्डर और उसके नीचे नेस्ट किए गए हर फ़ोल्डर की API कुंजियाँ निष्क्रिय हो जाती हैं।

फ़ोल्डर को फिर से शुरू करना

रुके हुए फ़ोल्डर को फिर से शुरू करने के लिए, "Folder API Key" मोडल को फिर से खोलें, पॉज़ नियंत्रण बंद करें, फिर पुष्टि करें। इससे फ़ोल्डर की API कुंजियाँ फिर से सक्रिय हो जाती हैं और सामान्य संचालन बहाल हो जाता है। इसी तरह, आप एक फ़ोल्डर और उसके सभी अवतारियों को एक साथ फिर से शुरू कर सकते हैं।

फिर से शुरू करना केवल उन्हीं कुंजियों को प्रभावित करता है जिन्हें फ़ोल्डर पॉज़ सुविधा द्वारा रोका गया था। अन्य कारणों से निष्क्रिय की गई कुंजियाँ प्रभावित नहीं होतीं।

फ़ोल्डर API कुंजियाँ

जब Billing Folders सक्षम होता है, तो प्रत्येक फ़ोल्डर को अपने-आप अपनी API कुंजी मिलती है। इन कुंजियों का उपयोग आंतरिक रूप से यह ट्रैक करने के लिए किया जाता है कि बिलयोग्य उपयोग किस फ़ोल्डर का है।

• कुंजियाँ देखना: किसी फ़ोल्डर से संबद्ध API कुंजियाँ देखने के लिए फ़ोल्डर के क्रिया मेनू से "Folder API Key" चुनें।

• स्वचालित निर्माण: फ़ोल्डर बनने पर या जब Billing Folders पहली बार आपके वर्कस्पेस पर सक्षम होता है, तब API कुंजियाँ अपने-आप बनाई जाती हैं। आपको उन्हें मैन्युअल रूप से बनाने की आवश्यकता नहीं है।

सामान्य परिदृश्य

परिदृश्य	क्या होता है
किसी प्रोजेक्ट को किसी अन्य फ़ोल्डर में ले जाना	उस प्रोजेक्ट के लिए भविष्य का उपयोग नए फ़ोल्डर को आवंटित किया जाता है। ऐतिहासिक उपयोग मूल फ़ोल्डर को आवंटित ही रहता है।
किसी फ़ोल्डर को हटाना	फ़ोल्डर आपके वर्कस्पेस से हटा दिया जाता है। चाइल्ड प्रोजेक्ट्स और सब-फ़ोल्डर्स को मूल फ़ोल्डर को फिर से असाइन कर दिया जाता है। ऐतिहासिक उपयोग डेटा बिलिंग रिपोर्टों में सुरक्षित रहता है।
नए फ़ोल्डर बनाना	नए फ़ोल्डरों को बिलिंग आवंटन के लिए अपने-आप एक API कुंजी मिलती है। किसी अतिरिक्त सेटअप की आवश्यकता नहीं है।
Billing Folders को अक्षम करना	फ़ोल्डर-स्तरीय आवंटन रुक जाता है। नया उपयोग केवल वर्कस्पेस स्तर पर ट्रैक किया जाता है। फ़ोल्डर बिलिंग अवधि का ऐतिहासिक उपयोग डेटा सुरक्षित रहता है।

उपयोग रिपोर्ट API

आप बिलिंग उपयोग रिपोर्ट REST API.

HTTP API

एंडपॉइंट

POST https://api.roboflow.com/{workspace_url}/billing-usage-report

प्रमाणीकरण

API कुंजी के साथ workspaceStats.read स्कोप, जिसे एक क्वेरी पैरामीटर के रूप में पास किया जाता है (?api_key=YOUR_API_KEY).

रेट सीमा

प्रति API कुंजी प्रति मिनट 10 अनुरोध।

अनुरोध पैरामीटर

सभी पैरामीटर अनुरोध बॉडी में JSON के रूप में पास किए जाते हैं। सभी वैकल्पिक हैं।

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
startAt	स्ट्रिंग (ISO 8601)	7 दिन पहले	रिपोर्टिंग अवधि की शुरुआत (सम्मिलित)
endAt	स्ट्रिंग (ISO 8601)	अभी	रिपोर्टिंग अवधि का अंत (बहिष्कृत)
api_key_prefixes	string या string[]	सभी कुंजियाँ	विशिष्ट API कुंजी प्रीफ़िक्स(ों) के अनुसार फ़िल्टर करें। प्रत्येक प्रीफ़िक्स पूर्ण API कुंजी के पहले 5 वर्ण होते हैं (उदा., rf_ab कुंजी के लिए rf_abCdEfGhIjK...). सटीक मिलान होना चाहिए।
features	string या string[]	सभी फ़ीचर्स	विशिष्ट बिलिंग फ़ीचर(रों) के अनुसार फ़िल्टर करें

उदाहरण

मूल

डिफ़ॉल्ट रूप से पिछले 7 दिन, सभी फ़ीचर्स, सभी API कुंजियाँ।

curl -X POST "https://api.roboflow.com/my-workspace/billing-usage-report?api_key=$ROBOFLOW_API_KEY"

कस्टम तिथि सीमा

curl -X POST "https://api.roboflow.com/my-workspace/billing-usage-report?api_key=$ROBOFLOW_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "startAt": "2025-01-01T00:00:00.000Z",
    "endAt": "2025-02-01T00:00:00.000Z"
  }'

फ़ीचर के अनुसार फ़िल्टर करें

curl -X POST "https://api.roboflow.com/my-workspace/billing-usage-report?api_key=$ROBOFLOW_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "features": ["train", "serverless-inference-run"]
  }'

सभी पैरामीटर

curl -X POST "https://api.roboflow.com/my-workspace/billing-usage-report?api_key=$ROBOFLOW_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "startAt": "2025-01-01T00:00:00.000Z",
    "endAt": "2025-02-01T00:00:00.000Z",
    "api_key_prefixes": ["rf_ab", "rf_de"],
    "features": ["train", "serverless-inference-run"]
  }'

प्रतिक्रिया स्कीमा

API उपयोग रिकॉर्डों की एक JSON array लौटाता है:

[
    {
        "api_key_prefix": "rf_ab",
        "feature": "train",
        "total_credits_used": 150.5,
        "usage_events": 12,
        "earliest_usage": "2025-01-02T10:30:00.000Z",
        "latest_usage": "2025-01-28T14:15:00.000Z",
        "billing_entity_id": "folder-id-123",
        "billing_entity_name": "My Project Folder",
        "billing_entity_type": "folder"
    }
]

फ़ील्ड	प्रकार	विवरण
api_key_prefix	string	उपयोग से संबद्ध API कुंजी के पहले 5 वर्ण
feature	string	बिलिंग फ़ीचर पहचानकर्ता (उदा., "train", "serverless-inference-run")
total_credits_used	number	इस key/feature संयोजन के लिए उपभोग किए गए कुल क्रेडिट
usage_events	number	व्यक्तिगत उपयोग घटनाओं की संख्या
earliest_usage	string	दायरे में पहली उपयोग घटना का ISO टाइमस्टैम्प
latest_usage	string	दायरे में अंतिम उपयोग घटना का ISO टाइमस्टैम्प
billing_entity_id	string	इस उपयोग का स्वामी फ़ोल्डर ID या वर्कस्पेस ID
billing_entity_name	string	बिलिंग इकाई का मानव-पठनीय नाम
billing_entity_type	string	या तो "folder" या "workspace"

त्रुटि कोड

स्थिति	विवरण
400	इस वर्कस्पेस के लिए Billing Folders सक्षम नहीं है, या अनुरोध पैरामीटर अमान्य हैं
401	अमान्य या अनुपस्थित API कुंजी, या अपर्याप्त अनुमतियाँ
423	फ़ोल्डर का उपयोग रोका गया है
429	रेट सीमा पार हो गई (प्रति मिनट 10 अनुरोध)