Billing Folders

Billing Folders workspace administrators को folder level पर billable usage को track और manage करने देता है।

Billing Folders एक प्रीमियम feature है जो Enterprise plans के लिए उपलब्ध है। अपने workspace के लिए Billing Folders सक्षम करने के लिए, संपर्क करें Roboflow sales team से या अपने account representative से। उपलब्ध plans के बारे में अधिक जानकारी के लिए, देखें हमारा pricing page.

जब enabled होता है, तो सभी usage (जैसे: training, inference, image storage, labeling, और अधिक) अपने-आप उस folder को attributed हो जाता है जिसमें उपयोग किए जा रहे project का स्थान है। इससे organizations को teams, departments, या clients के across detailed cost visibility और spending control मिलता है।

Usage Attribution कैसे काम करता है

जब Billing Folders enabled होता है, तो आपके workspace के हर folder को अपनी अलग API key मिलती है। किसी folder के projects के भीतर होने वाली सभी billable usage उस folder की API key के against track की जाती है। इसका मतलब है कि आप अपने usage reports और dashboard में साफ़-साफ़ देख सकते हैं कि हर folder कितना consume कर रहा है।

Usage attribution automatic है। आपको usage को manually folders में assign करने की ज़रूरत नहीं है। यह project से उसके parent folder तक flow होता है।

API या Deployment Usage

जब आप API key का उपयोग करके Roboflow services का उपयोग करते हैं (जिसमें, लेकिन सीमित नहीं, Serverless API, Batch Processing, आदि शामिल हैं), तो billing attribution request में मौजूद API key के अनुसार होता है, न कि project के folder के अनुसार।

workspace-level API key के साथ की गई request workspace को attributed होती है, भले ही उपयोग किया गया model किसी ऐसे project से संबंधित हो जो folder में मौजूद है। direct API या batch usage को किसी folder को attribute करने के लिए, उस folder की API key के साथ request करें।

Image Storage Attribution

Image storage उस folder को attributed होता है जिसमें image को reference करने वाले project(s) शामिल हैं।

यदि कोई image एक ही folder के भीतर कई projects में साझा की गई है (या same parent के subfolders के भीतर), तो storage उस deepest folder को attributed होता है जिसमें उस image का उपयोग करने वाले सभी projects शामिल हैं:

Workspace
├── Folder A
│   ├── Project 1  ← image.jpg
│   └── Project 2  ← image.jpg (shared)
└── Folder B
    └── Project 3

image.jpg storage को Folder A को attributed किया जाता है (वह deepest folder जिसमें इसे reference करने वाले सभी projects शामिल हैं)

यदि कोई image different root folders में मौजूद projects के बीच shared है और कोई common parent folder नहीं है, तो storage workspace level पर attributed होता है:

Workspace
├── Folder A
│   └── Project 1  ← image.jpg
└── Folder B
    └── Project 2  ← image.jpg (shared)

image.jpg storage को Workspace को attributed किया जाता है (कोई single folder दोनों projects को शामिल नहीं करता)

Usage देखना

आप usage देख सकते हैं, जिसमें folder के अनुसार breakdown भी शामिल है, अपने workspace के credit usage page में, और attribution filter को Folders. Learn कैसे usage को किसी billing folder के लिए filter करें या usage को सामान्य रूप से कैसे देखें।

Folder Usage को Pause और Resume करना

Workspace administrators किसी folder के भीतर सभी billable usage को अस्थायी रूप से pause कर सकते हैं। यह costs को नियंत्रित करने या accidental usage को रोकने के लिए उपयोगी है।

एक Folder को Pause करना

किसी folder को pause करने के लिए, खोलें Folder Settings modal और toggle करें Pause Folder Usage.

जब कोई folder paused होता है:

• उस folder से संबंधित सभी API keys disable हो जाती हैं

• कोई भी API request जो उस folder के against usage उत्पन्न करती, उसे 423 Locked status code के साथ reject कर दिया जाता है

• folder के लिए कोई नया billable usage रिकॉर्ड नहीं किया जाता

आप Pause All Descendant Folders' Usage को toggle करके किसी folder और उसके सभी descendant folders को एक साथ pause भी कर सकते हैं। इससे selected folder और उसके नीचे nested हर folder की API keys disable हो जाती हैं।

एक Folder को Resume करना

किसी paused folder को resume करने के लिए, "Folder Settings" modal पर वापस जाएँ और pause control को off करें। इससे folder की API keys फिर से सक्षम हो जाती हैं और सामान्य operation बहाल हो जाता है। इसी तरह, आप एक folder और उसके सभी descendants को भी एक साथ resume कर सकते हैं।

Resume करना केवल उन keys को प्रभावित करता है जिन्हें folder pause feature द्वारा pause किया गया था। जो keys अन्य कारणों से disable की गई थीं, वे प्रभावित नहीं होतीं।

Folder API Keys

जब Billing Folders enabled होता है, तो हर folder को अपने-आप अपनी API key मिलती है। इन keys का उपयोग internally यह track करने के लिए किया जाता है कि billable usage किस folder की है।

• keys देखना: Folder Settings modal खोलें और किसी folder से जुड़ी API keys देखने के लिए API Keys tab पर जाएँ।

• Automatic creation: folders बनते ही या जब आपके workspace पर Billing Folders पहली बार enabled होता है, तब API keys अपने-आप बनाई जाती हैं। आपको इन्हें manually बनाने की ज़रूरत नहीं है।

Common Scenarios

Scenario	क्या होता है
किसी project को किसी different folder में move करना	उस project के लिए future usage नए folder को attributed होता है। historical usage original folder को attributed ही रहता है।
किसी folder को delete करना	folder आपके workspace से हटा दिया जाता है। child projects और sub-folders को parent folder को reassigned कर दिया जाता है। historical usage data billing reports में preserved रहता है।
नए folders बनाना	नए folders को billing attribution के लिए अपने-आप एक API key मिल जाती है। कोई अतिरिक्त setup आवश्यक नहीं है।
Billing Folders को Disable करना	Folder-level attribution रुक जाती है। नया usage केवल workspace level पर track किया जाता है। folder billing period का historical usage data preserved रहता है।

Usage Report API

आप programmatically billing usage data को query कर सकते हैं billing usage report REST API.