> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/hi/platform/billing-and-plans/billing-folders.md).

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

## के बारे में

{% hint style="info" %}
Billing Folders एक है **प्रीमियम** Enterprise प्लान्स के लिए उपलब्ध एक सुविधा है। अपने वर्कस्पेस के लिए Billing Folders सक्षम करने के लिए, संपर्क करें [Roboflow सेल्स टीम](https://roboflow.com/sales) या अपने खाता प्रतिनिधि से संपर्क करें। उपलब्ध प्लानों के बारे में अधिक जानकारी के लिए, देखें [हमारे प्राइसिंग पेज](https://roboflow.com/pricing).
{% endhint %}

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

### उपयोग एट्रिब्यूशन कैसे काम करता है

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

{% hint style="info" %}
उपयोग एट्रिब्यूशन स्वचालित है। आपको मैन्युअल रूप से उपयोग को फ़ोल्डरों को असाइन करने की आवश्यकता नहीं है। यह प्रोजेक्ट से उसके पैरेंट फ़ोल्डर तक प्रवाहित होता है।
{% endhint %}

#### API या डिप्लॉयमेंट उपयोग

जब आप API कुंजी का उपयोग करके Roboflow सेवाओं का उपयोग करते हैं (Serverless 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 का स्टोरेज Workspace को एट्रिब्यूट किया जाता है (कोई एकल फ़ोल्डर दोनों प्रोजेक्ट्स को शामिल नहीं करता)
```

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

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

### उपयोग देखना

आप अपने वर्कस्पेस के क्रेडिट उपयोग पेज पर, फ़ोल्डर के अनुसार विभाजित सहित, उपयोग देख सकते हैं और एट्रिब्यूशन फ़िल्टर को बदल सकते हैं **फ़ोल्डर्स**. जानें [कि उपयोग को बिलिंग फ़ोल्डर के अनुसार कैसे फ़िल्टर करें](/get-started/hi/platform/billing-and-plans/credits/view-credit-usage.md#usage-chart) या [कि सामान्य रूप से उपयोग कैसे देखें।](/get-started/hi/platform/billing-and-plans/credits/view-credit-usage.md)

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

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

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

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

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

<figure><img src="/files/c4cabeb5fbf6982d939eaf5460730f7141050239" alt=""><figcaption></figcaption></figure>

<div><figure><img src="/files/0f1536147fc95d655fdad136b45f2b0c14ac264b" alt=""><figcaption></figcaption></figure> <figure><img src="/files/d5e1636be9eb7f5f64e5cf99070c980ecc6fd651" alt=""><figcaption></figcaption></figure></div>

जब कोई फ़ोल्डर रोका जाता है:

* उस फ़ोल्डर से संबंधित सभी 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

आप बिलिंग उपयोग डेटा को प्रोग्रामेटिक रूप से इस का उपयोग करके क्वेरी कर सकते हैं [billing usage report REST API](#http-api).

## HTTP API

**एंडपॉइंट**

<mark style="color:हरा;">`POST`</mark> `https://api.roboflow.com/{workspace_url}/billing-usage-report`

**प्रमाणीकरण**

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

**दर सीमा**

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

#### अनुरोध पैरामीटर <a href="#request-parameters" id="request-parameters"></a>

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

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

#### उदाहरण <a href="#examples" id="examples"></a>

{% tabs %}
{% tab title="बेसिक" %}
डिफ़ॉल्ट रूप से पिछले 7 दिन, सभी फ़ीचर्स, सभी API कुंजियाँ।

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

{% endtab %}

{% tab title="कस्टम दिनांक सीमा" %}

```shellscript
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"
  }'
```

{% endtab %}

{% tab title="फ़ीचर के अनुसार फ़िल्टर करें" %}

```shellscript
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"]
  }'
```

{% endtab %}

{% tab title="सभी पैरामीटर" %}

```shellscript
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"]
  }'
```

{% endtab %}
{% endtabs %}

#### प्रतिक्रिया स्कीमा <a href="#response-schema" id="response-schema"></a>

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

```json
[
    {
        "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`      | स्ट्रिंग | उपयोग से संबद्ध API कुंजी के पहले 5 अक्षर                               |
| `feature`             | स्ट्रिंग | बिलिंग फ़ीचर पहचानकर्ता (उदा., `"train"`, `"serverless-inference-run"`) |
| `total_credits_used`  | संख्या   | इस कुंजी/फ़ीचर संयोजन के लिए उपयोग किए गए कुल क्रेडिट                   |
| `usage_events`        | संख्या   | व्यक्तिगत उपयोग घटनाओं की संख्या                                        |
| `earliest_usage`      | स्ट्रिंग | सीमा में पहली उपयोग घटना का ISO टाइमस्टैम्प                             |
| `latest_usage`        | स्ट्रिंग | सीमा में अंतिम उपयोग घटना का ISO टाइमस्टैम्प                            |
| `billing_entity_id`   | स्ट्रिंग | इस उपयोग का स्वामी फ़ोल्डर ID या वर्कस्पेस ID                           |
| `billing_entity_name` | स्ट्रिंग | बिलिंग इकाई का मानव-पठनीय नाम                                           |
| `billing_entity_type` | स्ट्रिंग | या तो `"folder"` या `"workspace"`                                       |

#### त्रुटि कोड <a href="#error-codes" id="error-codes"></a>

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