> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-hosts/api.md).

# एपीआई

> 💡 **Python डेवलपर्स:** आधिकारिक [clore-ai Python SDK](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/developers/python-sdk.md) के बजाय सीधे API कॉल का उपयोग करें। यह प्रमाणीकरण, रेट सीमित करना, पुनः प्रयास, और त्रुटि-निपटान को स्वतः संभालता है।
>
> **त्वरित शुरुआत:** `pip install clore-ai` — देखें [Python SDK दस्तावेज़](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/developers/python-sdk.md) और [CLI संदर्भ](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/developers/cli-guide.md).

> 🧭 क्या आपको ब्राउज़ करने योग्य संदर्भ पसंद है? इंटरैक्टिव API दस्तावेज़ खोलें: [clore.ai/api-docs](https://clore.ai/api-docs). इस पृष्ठ के सभी एंडपॉइंट्स के लिए बेस URL: `https://api.clore.ai/v1/`.

<div data-full-width="true"><figure><img src="https://3219592360-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbyNlC5NV8aIpXnc76G7w%2Fuploads%2FoEhopGeayaKnbuDjgTEs%2FCLORE%20Docs%20API%20Page.png?alt=media&amp;token=a0adf6bb-1fde-4f1b-8236-dff2563ffbfd" alt=""><figcaption></figcaption></figure></div>

### परिचय <a href="#introduction" id="introduction"></a>

[CLORE.AI](http://clore.ai/) api का उपयोग आपके वर्कलोड्स की तैनाती को स्वचालित करने के लिए किया जा सकता है onto [CLORE.AI](http://clore.ai/)

सबसे पहले आपको एक API कुंजी प्राप्त करनी होगी\
![alt text](https://clore.ai/assets/html/api-export1.png)\
![alt text](https://clore.ai/assets/html/api-export2.png)

***

### API प्रतिक्रियाएँ <a href="#api-responses" id="api-responses"></a>

प्रतिक्रियाएँ JSON प्रारूप में लौटाई जाती हैं, इनमें अलग-अलग फ़ील्ड हो सकते हैं

हमेशा लौटाया जाने वाला फ़ील्ड code है, जो स्थिति दर्शाता है

**code फ़ील्ड**

| code | विवरण                               |
| ---- | ----------------------------------- |
| `0`  | NORMAL                              |
| `1`  | DATABASE ERROR                      |
| `2`  | INVALID INPUT DATA                  |
| `3`  | INVALID API TOKEN                   |
| `4`  | INVALID ENDPOINT                    |
| `5`  | 1 अनुरोध/सेकंड की सीमा पार हो गई    |
| `6`  | में निर्दिष्ट त्रुटि `error` फ़ील्ड |

***

### एंडपॉइंट्स <a href="#endpoints" id="endpoints"></a>

#### 1. `wallets` <a href="#id-1-wallets" id="id-1-wallets"></a>

**के बारे में**

वॉलेट और शेष राशि लौटाएँ

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड    | प्रकार     | विवरण           |
| --------- | ---------- | --------------- |
| `code`    | `int`      | स्थिति कोड      |
| `wallets` | `[]string` | वॉलेट्स की सरणी |

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/wallets'
```

**आउटपुट:**

```
{
  "wallets": [
    {
      "name": "bitcoin",
      "deposit": "tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr",
      "balance": 0.00153176,
      "withdrawal_fee": 0.0001
    }
  ],
  "code": 0
}
```

#### 2. `my_servers` <a href="#id-2-my_servers" id="id-2-my_servers"></a>

**के बारे में**

वे सर्वर लौटाता है जिन्हें आप प्रदान कर रहे हैं [clore.ai](http://clore.ai/) मार्केटप्लेस

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                                | प्रकार     | विवरण                                                                                                                                                                                                                                                                  |
| ------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                                | `int`      | स्थिति कोड                                                                                                                                                                                                                                                             |
| `सीमा`                                | `int`      | आपके पास हो सकने वाले सर्वरों की अधिकतम संख्या                                                                                                                                                                                                                         |
| `servers`                             | `[]string` | सर्वरों की सरणी                                                                                                                                                                                                                                                        |
| `servers[x].name`                     | `स्ट्रिंग` | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                                                                                                                                                                                   |
| `servers[x].connected`                | `स्ट्रिंग` | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                                                                                                                                                                              |
| `servers[x].visibility`               | `स्ट्रिंग` | मार्केटप्लेस पर दृश्यता                                                                                                                                                                                                                                                |
| `servers[x].pricing`                  | `[]string` | मूल्य/दिन, ऑन-डिमांड                                                                                                                                                                                                                                                   |
| `servers[x].online`                   | `bool`     | क्या सर्वर ऑनलाइन है                                                                                                                                                                                                                                                   |
| `servers[x].min_spot_pricing`         | `[]string` | स्पॉट मार्केट पर किराये के लिए न्यूनतम मूल्य/दिन                                                                                                                                                                                                                       |
| `servers[x].auto_renew_allowed`       | `bool`     | क्या इस सर्वर पर किराएदारों के ऑन-डिमांड ऑर्डर अधिकतम किराया अवधि तक पहुँचने पर आपकी वर्तमान कीमत पर नवीनीकृत हो सकते हैं। `true` जब आपने इसे कभी सेट नहीं किया। हटाए जा रहे सर्वर पर अनुपस्थित। इसे इसके साथ बदलें [`set_server_settings`](#id-7-set_server_settings) |
| `servers[x].init_token`               | `स्ट्रिंग` | मशीन-पंजीकरण टोकन, केवल मशीन के प्रारंभ होने तक लौटाया जाता है — **इसे एक प्रमाण-पत्र की तरह मानें**, यह मशीनों को आपके खाते में पंजीकृत करता है                                                                                                                       |
| `servers[x].specs`                    | `[]string` | सर्वर विनिर्देश                                                                                                                                                                                                                                                        |
| `servers[x].remaining_time`           | `int`      | सबसे हालिया सक्रिय ऑर्डर का किराया समाप्ति समय (ms epoch)                                                                                                                                                                                                              |
| `servers[x].rental_state`             | `स्ट्रिंग` | संचयी GPU किराया स्थिति: `कोई नहीं`, `आंशिक`या `पूर्ण`                                                                                                                                                                                                                 |
| `servers[x].rented_gpus`              | `int`      | सक्रिय ऑर्डरों में वर्तमान में किराए पर लिए गए GPUs                                                                                                                                                                                                                    |
| `servers[x].total_gpus`               | `int`      | सर्वर पर कुल GPUs                                                                                                                                                                                                                                                      |
| `servers[x].rented_price_by_currency` | `ऑब्जेक्ट` | मुद्रा के अनुसार कुंजीबद्ध सक्रिय ऑर्डर कीमतों का योग                                                                                                                                                                                                                  |
| `servers[x].update_channel`           | `स्ट्रिंग` | होस्टिंग-एजेंट अपडेट चैनल: `स्थिर` या `बीटा`                                                                                                                                                                                                                           |
| `servers[x].requested_channel`        | `स्ट्रिंग` | वेब UI से चैनल स्विच का अनुरोध किया गया (केवल अनुरोधित होने पर मौजूद)                                                                                                                                                                                                  |
| `servers[x].target_backend_version`   | `int`      | वर्तमान चैनल जिस बैकएंड संस्करण को लक्षित करता है                                                                                                                                                                                                                      |

> किराया-स्थिति फ़ील्ड्स (`remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`) केवल तब मौजूद होते हैं जब सर्वर के पास सक्रिय ऑर्डर हो।

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_servers'
```

**आउटपुट:**

```
{
  "servers": [
    {
      "name": "Michael",
      "connected": false,
      "visibility": "hidden",
      "pricing": { "bitcoin": 0, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0, "usd": 0 },
      "auto_renew_allowed": true,
      "init_token": "qnwVIMsZPjUWS7jw6gAbTOeoGQNgTH9XVxJaiCEbG0OlmfjF"
    },
    {
      "name": "Jan Vykydal",
      "connected": true,
      "visibility": "public",
      "pricing": { "bitcoin": 0.00010337, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "Intel Core i9-11900",
        "cpus": "8/16",
        "ram": 64,
        "disk": "NVMe 512GB",
        "disk_speed": 2000,
        "gpu": "1x GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "down":119.61,
          "up":25.24
        }
      }
    }
  ],
  "limit": 16,
  "code": 0
}
```

USD मान `pricing` ऑब्जेक्ट्स उस USD-आधारित मूल्य निर्धारण मोड को दर्शाते हैं जिसे होस्ट ने सक्षम किया है।

#### 3. `server_config` <a href="#id-3-server_config" id="id-3-server_config"></a>

**के बारे में**

विशिष्ट सर्वर का कॉन्फ़िगरेशन प्राप्त करें

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड      | प्रकार     | अनिवार्य | विवरण     |
| ----------- | ---------- | -------- | --------- |
| `सर्वर नाम` | `स्ट्रिंग` | हाँ      | सर्वर नाम |

**आउटपुट**

| फ़ील्ड                      | प्रकार                   | विवरण                                                                                                     |
| --------------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------- |
| `code`                      | `int`                    | स्थिति कोड                                                                                                |
| `creation_completed`        | `bool`                   | क्या सर्वर निर्माण पूरा हो गया है                                                                         |
| `config`                    | `[]string`               | सर्वर का कॉन्फ़िगरेशन                                                                                     |
| `config.name`               | `स्ट्रिंग`               | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                      |
| `config.connected`          | `bool`                   | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                 |
| `config.visibility`         | `स्ट्रिंग`               | मार्केटप्लेस पर दृश्यता                                                                                   |
| `config.pricing`            | `[]string`               | मूल्य/दिन, ऑन-डिमांड                                                                                      |
| `config.spot_pricing`       | `[]string`               | स्पॉट मार्केट पर किराये के लिए न्यूनतम मूल्य/दिन                                                          |
| `config.mrl`                | `int`                    | घंटों में अधिकतम किराये की अवधि                                                                           |
| `config.auto_renew_allowed` | `bool`                   | क्या इस सर्वर पर किराएदारों के ऑन-डिमांड ऑर्डर `mrl`. `true` जब आपने इसे कभी सेट नहीं किया                |
| `config.online`             | `bool`                   | क्या सर्वर ऑनलाइन है                                                                                      |
| `config.initialized`        | `bool`                   | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                 |
| `config.id`                 | `int`                    | अद्वितीय सर्वर ID                                                                                         |
| `config.rental_status`      | `int`                    | 0 - किराये पर नहीं \| 1 - स्पॉट मार्केट पर किराये पर \| 2 - ऑन डिमांड किराये पर \| 3 - फिक्स्ड-USD किराया |
| `config.specs`              | `[]string`               | सर्वर विनिर्देश                                                                                           |
| `config.background_job`     | `ऑब्जेक्ट`               | किराये पर न होने पर बैकग्राउंड जॉब: `image`, `command`, `env`, `times_updated`                            |
| `config.autoprice`          | `ऑब्जेक्ट` \| `स्ट्रिंग` | प्रति-मुद्रा ऑटोप्राइसिंग कॉन्फ़िगरेशन (पुराने स्ट्रिंग मान `"pow"` / `"usd"` भी दिखाई दे सकते हैं)       |
| `config.usd_pricing`        | `ऑब्जेक्ट`               | USD मूल्य लक्ष्य — केवल तब मौजूद जब USD ऑटोप्राइसिंग सक्षम हो                                             |
| `config.tenants`            | `[]object`               | सर्वर पर सक्रिय ऑर्डर: `rental_type`, `currency`, `मूल्य`, `remaining_time`, `gpu_count`                  |

> `server_config` वही किराया-स्थिति और अपडेट-चैनल फ़ील्ड्स भी लौटाता है जैसे `my_servers`: `remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`, `update_channel`, `requested_channel`, `target_backend_version`. दोनों एंडपॉइंट्स में किराया-स्थिति फ़ील्ड्स केवल तब मौजूद होती हैं जब सर्वर के पास सक्रिय ऑर्डर हो।

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "server_name":"Jan Vykydal"
}' 'https://api.clore.ai/v1/server_config'
```

**आउटपुट:**

```
{
  "config": {
    "name": "Jan Vykydal",
    "connected": true,
    "visibility": "public",
    "pricing": { "bitcoin": 0.00010337, "usd": 0 },
    "spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
    "mrl": 72,
    "auto_renew_allowed": true,
    "online": false,
    "initialized": true,
    "id": 4,
    "rental_status": 0,
    "specs": {
      "mb": "Z590 GAMING X",
      "cpu": "Intel Core i9-11900",
      "cpus": "8/16",
      "ram": 64,
      "disk": "NVMe 512GB",
      "disk_speed": 2000,
      "gpu": "1x GeForce GTX 1080 Ti",
      "gpuram": 11,
      "net": {
        "down":119.61,
        "up":25.24
      }
    },
    "background_job": {
      "times_updated": 1,
      "image": "cloreai/ubuntu20.04-jupyter",
      "command": "",
      "env": []
    }
  },
  "creation_completed": true,
  "code": 0
}
```

USD मान `pricing` ऑब्जेक्ट्स उस USD-आधारित मूल्य निर्धारण मोड को दर्शाते हैं जिसे होस्ट ने सक्षम किया है।

#### 4. `मार्केटप्लेस` <a href="#id-4-marketplace" id="id-4-marketplace"></a>

**के बारे में**

मार्केटप्लेस प्राप्त करें

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                          | प्रकार               | विवरण                                                                                                                                                                                                                                                          |
| ------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                          | `int`                | स्थिति कोड                                                                                                                                                                                                                                                     |
| `my_servers`                    | `[]string`           | सर्वर आईडी की सरणी जिन्हें आप प्रदान कर रहे हैं [clore.ai](http://clore.ai/) (किराये पर नहीं लिया जा सकता)                                                                                                                                                     |
| `servers`                       | `[]string`           | मार्केटप्लेस पर सार्वजनिक सर्वरों की सरणी                                                                                                                                                                                                                      |
| `servers[x].id`                 | `int`                | अद्वितीय सर्वर ID                                                                                                                                                                                                                                              |
| `servers[x].owner`              | `int`                | अद्वितीय मालिक ID                                                                                                                                                                                                                                              |
| `servers[x].mrl`                | `int`                | घंटों में अधिकतम किराया अवधि। जब सर्वर ऑटो-नवीनीकरण की अनुमति देता है, तो यह पुनःमूल्य निर्धारण अवधि भी होती है: नवीनीकृत होने वाला ऑर्डर हर बार इस अवधि पर पहुँचने पर होस्ट की वर्तमान कीमत लेता है                                                           |
| `servers[x].auto_renew_allowed` | `bool`               | क्या होस्ट इस सर्वर पर ऑटो-नवीनीकरण की अनुमति देता है। `true` जब होस्ट ने इसे कभी सेट नहीं किया। जब `false`, `create_order` के साथ `auto_renew: true` अस्वीकार कर दिया जाता है, साथ में `auto_renew_not_allowed`, और `rental_hours` से अधिक नहीं हो सकता `mrl` |
| `servers[x].price.on_demand`    | `[]string`           | प्रति दिन ऑन-डिमांड मूल्य                                                                                                                                                                                                                                      |
| `servers[x].price.spot`         | `[]string`           | प्रति दिन न्यूनतम स्पॉट मार्केट मूल्य                                                                                                                                                                                                                          |
| `servers[x].rented`             | `bool`               | क्या सर्वर ऑन डिमांड किराये पर है                                                                                                                                                                                                                              |
| `servers[x].specs`              | `[]string`           | सर्वर विनिर्देश                                                                                                                                                                                                                                                |
| `servers[x].partial_gpu_rental` | `ऑब्जेक्ट` \| `bool` | `false` जब आंशिक किराया उपलब्ध नहीं हो, अन्यथा `{ total_gpus, available_gpus, free_indices }`                                                                                                                                                                  |

> `price.on_demand` और `price.spot` केवल वही मुद्राएँ शामिल करें जिन्हें प्रत्येक सर्वर वास्तव में स्वीकार करता है — किसी ऐसी मुद्रा में कीमत न होने पर सर्वर उसे स्वीकार नहीं कर सकता।
>
> सूची एक कैश्ड स्नैपशॉट है, इसलिए किसी सर्वर के `mrl` या `auto_renew_allowed` में बदलाव यहाँ दिखने में कुछ मिनट लग सकते हैं।

**उदाहरण**

मार्केटप्लेस प्राप्त करें

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/marketplace'
```

**आउटपुट:**

```
{
  "servers": [
    {
      "id": 6,
      "owner": 4,
      "mrl": 73,
      "price": { "on_demand": { "bitcoin": 0.00001 },
      "spot": { "bitcoin": 0.000001 }},
      "rented": false,
      "auto_renew_allowed": true,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 0,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
          "cc": "CZ"
        }
      }
    }
  ],
  "my_servers": [1, 2, 4],
  "code": 0
}
```

#### 5. `my_orders` <a href="#id-5-my_orders" id="id-5-my_orders"></a>

**के बारे में**

अपने ऑर्डर प्राप्त करें

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**क्वेरी स्ट्रिंग**

| फ़ील्ड             | प्रकार | अनिवार्य | विवरण                       |
| ------------------ | ------ | -------- | --------------------------- |
| `return_completed` | `bool` | नहीं     | पूर्ण (समाप्त) ऑर्डर लौटाएँ |

**आउटपुट**

| फ़ील्ड                           | प्रकार     | विवरण                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                           | `int`      | स्थिति कोड                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `सीमा`                           | `int`      | वर्तमान में हमेशा 999999                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `orders`                         | `[]string` | ऑर्डरों की सरणी                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].id`                   | `int`      | अद्वितीय ऑर्डर ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].creation_fee`         | `float`    | भुगतान किया गया निर्माण शुल्क [clore.ai](http://clore.ai/)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].price`                | `float`    | ऑर्डर मूल्य (लागत) प्रति दिन                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| `orders[x].mrl`                  | `int`      | निर्माण से वर्तमान अवधि के अंत तक के सेकंड। नवीनीकरण इसमें नई अवधि जोड़ देता है, इसलिए `ct + mrl` हमेशा वर्तमान समाप्ति होती है                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].image`                | `स्ट्रिंग` | उपयोग की गई Docker इमेज                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].currency`             | `स्ट्रिंग` | बिलिंग के लिए उपयोग की गई मुद्रा                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].spend`                | `float`    | अब तक डेबिट की गई वास्तविक राशि: संचित किराया मूल्य + किराएदार आधार शुल्क (PoH कटौती के बाद) और कोई भी अतिरिक्त शुल्क; इसमें एकमुश्त निर्माण शुल्क शामिल नहीं है                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `orders[x].gpu_count`            | `int`      | ऑर्डर द्वारा घिरे गए GPU की संख्या (ऑन-डिमांड ऑर्डर; यह रिग के कुल GPU के बराबर होती है, जब तक कि यह आंशिक किराया न हो)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].ct`                   | `int`      | निर्माण समय (UNIX time)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].p`                    | `int`      | वर्तमान में उपयोग किया जा रहा प्रॉक्सी क्लस्टर                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].specs`                | `[]string` | सर्वर विनिर्देश                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].si`                   | `int`      | अद्वितीय सर्वर ID                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].pub_cluster`          | `[]string` | फ़ॉरवर्ड किए गए पोर्ट्स वाले सार्वजनिक एंडपॉइंट्स                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].tcp_ports`            | `[]string` | TCP पोर्ट फ़ॉरवर्डिंग                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].http_port`            | `स्ट्रिंग` | HTTPS प्रॉक्सी के माध्यम से फ़ॉरवर्ड किया गया कंटेनर पोर्ट                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].spot`                 | `bool`     | यह स्पॉट ऑर्डर है, इसका संकेत                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].expired`              | `bool`     | यह संकेत कि ऑर्डर समाप्त हो गया है                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `orders[x].rental_hours`         | `int`      | आपके द्वारा मांगे गए घंटे, निर्माण से गिने गए (केवल ऑन-डिमांड)। जब कोई सीमा अनुरोधित नहीं की गई हो, तब अनुपस्थित: ऑर्डर फिर होस्ट की अधिकतम किराया अवधि पर समाप्त होता है, जब तक कि `auto_renew` चालू हो, जिस स्थिति में यह तब तक चलता है जब तक आप रद्द न करें                                                                                                                                                                                                                                                                                                                                                                                                                              |
| `orders[x].rental_end`           | `int`      | अनुरोधित घंटे समाप्त होने का UNIX समय; जब कोई सीमा अनुरोधित न हो तो अनुपस्थित                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| `orders[x].term_start`           | `int`      | वर्तमान अवधि शुरू होने का UNIX समय (निर्माण, या अंतिम नवीनीकरण)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `orders[x].term_end`             | `int`      | वर्तमान अवधि समाप्त होने का UNIX समय; हमेशा `ct + mrl`. स्पॉट ऑर्डरों पर और ऑटो-नवीनीकरण के लागू होने से पहले बनाए गए तथा तब से कभी संपादित न किए गए ऑन-डिमांड ऑर्डर पर अनुपस्थित                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `orders[x].term_mrl`             | `int`      | वर्तमान अवधि शुरू होने पर होस्ट की अधिकतम किराया अवधि, सेकंड में। [`चल रहे ऑर्डर पर इन्हें बदलने के लिए, और`](#id-16-set_order_auto_renew) वर्तमान अवधि को अधिकतम तक बढ़ा सकता है `term_start + term_mrl`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `orders[x].last_renewal_at`      | `int`      | अंतिम नवीनीकरण लागू होने का UNIX समय; पहले नवीनीकरण से पहले अनुपस्थित                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].auto_renew`           | `bool`     | क्या वर्तमान अवधि समाप्त होने पर ऑर्डर होस्ट की वर्तमान कीमत पर नवीनीकृत होता है। इसे सेट किया जाता है `false` जब नवीनीकरण अस्वीकार हो जाता है। ऑटो-नवीनीकरण के बिना बनाए गए और कभी संपादित न किए गए ऑर्डर पर अनुपस्थित                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].auto_renew_max_price` | `float`    | नवीनीकरण के लिए आपकी प्रति-दिन मूल्य सीमा, ऑर्डर की मुद्रा में। जब होस्ट की कीमत इससे अधिक होती है, नवीनीकरण अस्वीकार कर दिया जाता है                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| `orders[x].renewals_count`       | `int`      | अब तक लागू किए गए नवीनीकरणों की संख्या; पहले नवीनीकरण से पहले अनुपस्थित                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `orders[x].pending_renewal`      | `ऑब्जेक्ट` | जब वर्तमान अवधि के अंत के लिए नवीनीकरण निर्धारित होता है, तब मौजूद: `मूल्य` (`float`, अगली अवधि की प्रति दिन कीमत) और `term_seconds` (`int`, अगली अवधि की लंबाई सेकंड में)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `orders[x].auto_renew_declined`  | `ऑब्जेक्ट` | नवीनीकरण अस्वीकृत होने के बाद उपस्थित: `कारण` और `पर` (निर्णय का UNIX समय)। ऑर्डर अपनी वर्तमान अवधि के साथ समाप्त होता है। `कारण` इनमें से एक है `price_above_cap` (होस्ट की नई प्रति-दिन कीमत इससे ऊपर है `auto_renew_max_price`), `server_unlisted` (सर्वर छिपा हुआ है या हटाया जा रहा है, अब ऑर्डर की मुद्रा स्वीकार नहीं करता या उसमें कोई कीमत नहीं है, या अब वे स्वास्थ्य जाँचें पास नहीं करता जो एक नए ऑर्डर को करनी होती हैं), `host_disallowed` (होस्ट ने स्वतः-नवीनीकरण बंद कर दिया), `server_reserved` (सर्वर किसी अन्य किराएदार के लिए आरक्षित है) या `insufficient_balance` (अवधि के अंत तक के समय का भुगतान करने के बाद, आपकी शेष राशि नई कीमत पर एक घंटे से भी कम कवर करेगी) |

> ऑटो-नवीनीकरण शुरू होने के बाद बनाए गए हर ऑन-डिमांड ऑर्डर में होता है `term_start`, `term_end` और `term_mrl`. अन्य नवीनीकरण फ़ील्ड केवल तभी दिखाई देते हैं जब वे लागू हों: `rental_hours` और `rental_end` जब घंटों का अनुरोध किया गया था, `auto_renew` और `auto_renew_max_price` जब स्वतः-नवीनीकरण निर्माण के समय अनुरोधित किया गया था या इसके माध्यम से सेट किया गया था [`चल रहे ऑर्डर पर इन्हें बदलने के लिए, और`](#id-16-set_order_auto_renew), और `renewals_count` और `last_renewal_at` पहले नवीनीकरण के बाद। देखें [किराया अवधि और स्वतः-नवीनीकरण](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-renters/order-management.md#rental-length-and-auto-renewal).

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_orders?return_completed=true'
```

नीचे दिया गया पहला ऑर्डर एक ऐसे सर्वर पर ऑन-डिमांड ऑर्डर है जिसकी अधिकतम किराये की अवधि 73 घंटे है (`mrl` 262800 सेकंड), के साथ बनाया गया, `rental_hours: 120` और ऑटो-नवीनीकरण चालू है, और अभी भी अपनी पहली अवधि में है। दूसरा एक समाप्त हो चुका स्पॉट ऑर्डर है।

**आउटपुट:**

```
{
  "orders": [
    {
      "id": 38,
      "creation_fee": 3e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 6.944444444444445e-9,
      "ct": 1667401396,
      "p": 1,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "pub_cluster": [ "n1.c1.clorecloud.net", "n2.c1.clorecloud.net" ],
      "tcp_ports": [ "22:10000" ],
      "http_port": "8888",
      "ssh_auth": "password",
      "rental_hours": 120,
      "rental_end": 1667833396,
      "term_start": 1667401396,
      "term_end": 1667664196,
      "term_mrl": 262800,
      "auto_renew_max_price": 0.0000125,
      "auto_renew": true
    },{
      "id": 36,
      "creation_fee": 1e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 1.3888888888888888e-7,
      "ct": 1667248597,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42
        }
      },
      "si": 6,
      "spot": true,
      "ssh_auth": "password",
      "expired": true,
      "tcp_ports": []
    }
  ],
  "limit": 999999,
  "code": 0
}
```

#### 6. `spot_marketplace` <a href="#id-6-spot_marketplace" id="id-6-spot_marketplace"></a>

**के बारे में**

विशिष्ट सर्वर के लिए स्पॉट मार्केटप्लेस प्राप्त करें

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**क्वेरी स्ट्रिंग**

| फ़ील्ड   | प्रकार | अनिवार्य | विवरण             |
| -------- | ------ | -------- | ----------------- |
| `बाज़ार` | `int`  | हाँ      | अद्वितीय सर्वर ID |

**आउटपुट**

| फ़ील्ड                         | प्रकार     | विवरण                                                                          |
| ------------------------------ | ---------- | ------------------------------------------------------------------------------ |
| `code`                         | `int`      | स्थिति कोड                                                                     |
| `मौजूद है`                     | `bool`     | यह सत्यापित करना कि बाज़ार मौजूद है                                            |
| `बाज़ार`                       | `ऑब्जेक्ट` | मार्केटप्लेस                                                                   |
| `market.offers`                | `सरणी`     | सर्वर के लिए किराये के प्रस्ताव                                                |
| `market.offers[x].offer_id`    | `int`      | अद्वितीय प्रस्ताव ID                                                           |
| `market.offers[x].bid`         | `float`    | प्रति दिन प्रस्तावित कीमत (प्रस्ताव की मुद्रा में)                             |
| `market.offers[x].currency`    | `स्ट्रिंग` | बिड की मुद्रा                                                                  |
| `market.offers[x].active`      | `bool`     | यह प्रस्ताव वर्तमान में उपयोग में है                                           |
| `market.offers[x].my`          | `bool`     | यह प्रस्ताव मेरा है                                                            |
| `market.server`                | `ऑब्जेक्ट` | सर्वर जानकारी                                                                  |
| `market.server.min_pricing`    | `ऑब्जेक्ट` | स्वीकृत प्रत्येक मुद्रा के लिए प्रति दिन न्यूनतम प्रस्ताव मूल्य                |
| `market.server.mrl`            | `int`      | अधिकतम किराये की अवधि में **घंटे**                                             |
| `market.server.visibility`     | `स्ट्रिंग` | आप केवल तभी प्रस्ताव बना सकते हैं जब दृश्यता सार्वजनिक हो                      |
| `market.server.online`         | `bool`     | सर्वर ऑनलाइन है                                                                |
| `market.currency_rates_in_usd` | `ऑब्जेक्ट` | विभिन्न मुद्राओं में बिड की तुलना करने के लिए उपयोग की जाने वाली लाइव USD दरें |

> प्रस्ताव सर्वर द्वारा स्वीकार की जाने वाली किसी भी मुद्रा में दिए जा सकते हैं; प्रतिस्पर्धी बिडों की तुलना उनके **USD मूल्य** (का उपयोग करके `currency_rates_in_usd`), अंकित मूल्य नहीं।
>
> ⚠️ **अगस्त 2026 में बदला गया:** `market.server.mrl` अब इसमें लौटाया जाता है **घंटे** (पहले सेकंड में)। जो मान पहले पढ़ा जाता था `262800` अब पढ़ा जाता है `73`.

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/spot_marketplace?market=6'
```

**आउटपुट:**

```
{
  "market": {
    "offers": [
      {
        "offer_id": 39,
        "bid": 0.0000042,
        "active": true,
        "my": true,
        "currency": "bitcoin"
      }
    ],
    "server": {
      "min_pricing": {
        "bitcoin": 0.000001
      },
      "mrl": 73,
      "visibility": "public",
      "online": true
    },
    "currency_rates_in_usd": {
      "bitcoin": 110000,
      "CLORE-Blockchain": 0.0045,
      "USD-Blockchain": 1
    }
  },
  "exists": true,
  "code": 0
}
```

#### 7. `set_server_settings` <a href="#id-7-set_server_settings" id="id-7-set_server_settings"></a>

**के बारे में**

उस सर्वर की सेटिंग्स कॉन्फ़िगर करें जिसे आप उपलब्ध करा रहे हैं [clore.ai](http://clore.ai/) मार्केटप्लेस

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड                       | प्रकार     | अनिवार्य | विवरण                                                                                                                                                                                                                                                                                                     |
| ---------------------------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `नाम`                        | `स्ट्रिंग` | हाँ      | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                                                                                                                                                                                                                      |
| `availability`               | `bool`     | हाँ      | क्या सर्वर किराये पर दिया जा सकता है                                                                                                                                                                                                                                                                      |
| `mrl`                        | `int`      | हाँ      | सर्वर की अधिकतम किराये की अवधि में **घंटे** (6 से 3000)                                                                                                                                                                                                                                                   |
| `bitcoin_on_demand`          | `float`    | हाँ      | प्रति दिन BTC में ऑन-डिमांड कीमत                                                                                                                                                                                                                                                                          |
| `bitcoin_spot`               | `float`    | हाँ      | प्रति दिन BTC में न्यूनतम स्पॉट कीमत                                                                                                                                                                                                                                                                      |
| `CLORE-Blockchain_on_demand` | `float`    | नहीं     | प्रति दिन CLORE में ऑन-डिमांड कीमत                                                                                                                                                                                                                                                                        |
| `CLORE-Blockchain_spot`      | `float`    | नहीं     | प्रति दिन CLORE में न्यूनतम स्पॉट कीमत                                                                                                                                                                                                                                                                    |
| `USD-Blockchain_on_demand`   | `float`    | नहीं     | प्रति दिन USD में ऑन-डिमांड कीमत                                                                                                                                                                                                                                                                          |
| `USD-Blockchain_spot`        | `float`    | नहीं     | प्रति दिन USD में न्यूनतम स्पॉट कीमत                                                                                                                                                                                                                                                                      |
| `enabled-bitcoin`            | `bool`     | नहीं\*   | इस सर्वर के लिए Bitcoin स्वीकार करें                                                                                                                                                                                                                                                                      |
| `enabled-CLORE-Blockchain`   | `bool`     | नहीं\*   | इस सर्वर के लिए CLORE स्वीकार करें                                                                                                                                                                                                                                                                        |
| `enabled-USD-Blockchain`     | `bool`     | नहीं\*   | इस सर्वर के लिए USD स्टेबलकॉइन्स स्वीकार करें                                                                                                                                                                                                                                                             |
| `autoprice`                  | `ऑब्जेक्ट` | नहीं     | प्रति-मुद्रा ऑटोप्राइसिंग: मुद्रा कुंजी सेट करें (`bitcoin`, `CLORE-Blockchain`) को `"usd"` USD-आधारित ऑटोप्राइसिंग के लिए या `false` नियत मूल्य निर्धारण के लिए                                                                                                                                          |
| `usd_pricing`                | `ऑब्जेक्ट` | नहीं     | प्रति मुद्रा USD मूल्य लक्ष्य, जैसे `{ "bitcoin": { "on_demand": 10, "spot": 5 } }` — केवल उन मुद्राओं के लिए उपयोग किया जाता है जिनके लिए `autoprice` सेट है `"usd"`                                                                                                                                     |
| `auto_renew_allowed`         | `bool`     | नहीं     | किराएदारों के ऑन-डिमांड ऑर्डरों को आपके वर्तमान मूल्य पर नवीनीकृत होने दें जब वे पहुँचें `mrl`. संग्रहीत सेटिंग बनाए रखने के लिए इसे छोड़ दें; जिस सर्वर पर यह कभी सेट नहीं किया गया, वह नवीनीकरण की अनुमति देता है। इससे भिन्न कोई मान `true` या `false` कोड के साथ अस्वीकार किया जाता है `2` (HTTP 400) |

> \* **स्वीकृत-मुद्रा सूची पुनर्निर्मित की जाती है `enabled-*` हर कॉल पर फ़्लैग्स से।** अपनी `enabled-<currency>: true` फ़्लैग (या वैध कीमत के बिना) सर्वर की स्वीकृत मुद्राओं से हटा दी जाती है — सभी फ़्लैग छोड़ देने पर सर्वर किसी भी मुद्रा में किराये पर नहीं दिया जा सकता। हमेशा भेजें `enabled-<currency>: true` प्रत्येक मुद्रा के लिए जिसे आप स्वीकार करते रहना चाहते हैं।
>
> प्रति दिन कीमतें प्रति मुद्रा सीमित हैं: 0.000001–0.1 BTC, 0.1–5,000,000 CLORE, 0.1–10,000 USD.
>
> जब किसी मुद्रा की ऑटोप्राइसिंग USD में होती है, तो उसकी सूचीबद्ध क्रिप्टो कीमत इससे निकाली जाती है `usd_pricing` लाइव विनिमय दर पर (लगभग हर 10 मिनट में पुनर्गणना की जाती है) और कोई भी `<currency>_on_demand` / `<currency>_spot` इसके लिए भेजा गया मान अनदेखा किया जाता है। `usd_pricing` लक्ष्य पूरे सर्वर के $/दिन आंकड़े हैं, जिन्हें USD सीमा (0.1 से 10,000) के विरुद्ध मान्य किया जाता है; सीमा से बाहर के मान निकटतम सीमा तक क्लैंप कर दिए जाते हैं।
>
> के साथ `auto_renew_allowed` चालू (डिफ़ॉल्ट) होने पर, `mrl` यह आपका पुनर्मूल्य निर्धारण काल भी होता है: जिस ऑर्डर के किराएदार ने स्वतः-नवीनीकरण चुना है, वह हर बार जब वह पहुँचता है तब नवीनीकृत होता है `mrl`, उस क्षण आपकी कीमत पर। इसे सेट करने से `false` चल रहे किराये को कभी समाप्त नहीं करता: सर्वर पर प्रत्येक ऑर्डर अपनी वर्तमान अवधि पूरी करता है और उसका नवीनीकरण इससे अस्वीकृत होता है `host_disallowed`.

**आउटपुट**

| फ़ील्ड | प्रकार | विवरण      |
| ------ | ------ | ---------- |
| `code` | `int`  | स्थिति कोड |

**उदाहरण**

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "name": "Jan Vykydal",
    "availability":true,
    "mrl":96,
    "enabled-bitcoin":true,
    "bitcoin_on_demand":0.0001,
    "bitcoin_spot":0.00000113
}' 'https://api.clore.ai/v1/set_server_settings'
```

**आउटपुट:**

```
{
  "code": 0
}
```

#### 8. `set_spot_price` <a href="#id-8-set_spot_price" id="id-8-set_spot_price"></a>

**के बारे में**

अपने SPOT बाज़ार प्रस्ताव पर प्रति दिन कीमत सेट करें

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड          | प्रकार  | अनिवार्य | विवरण                          |
| --------------- | ------- | -------- | ------------------------------ |
| `order_id`      | `int`   | हाँ      | अद्वितीय प्रस्ताव ID           |
| `desired_price` | `float` | हाँ      | आपकी प्रति दिन प्रस्तावित कीमत |

> **सर्वर के वर्तमान स्पॉट न्यूनतम से कम कीमत** वर्तमान न्यूनतम के साथ अस्वीकार की जाती है:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```
>
> **वृद्धि आपकी वर्तमान बिड और उसी मुद्रा में सर्वर की शीर्ष बिड, दोनों से कम से कम 1% अधिक होनी चाहिए** (मुद्रा की सटीकता तक ऊपर गोल किया गया, मूल्य सीमा पर सीमित)। छोटी वृद्धि निम्नतम स्वीकृत कीमत के साथ अस्वीकार की जाती है:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**उदाहरण**

आइए स्पॉट बाज़ार कीमत अपडेट करने की कोशिश करें

**इनपुट 1 (कदम घटाना बहुत बड़ा था):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000200
}' 'https://api.clore.ai/v1/set_spot_price'
```

**संभव आउटपुट 1 (कदम घटाना बहुत बड़ा था):**\
आप स्पॉट बाज़ार प्रस्ताव की कीमत अधिकतम 0.00000100 ₿ तक घटा सकते हैं

| फ़ील्ड     | प्रकार     | विवरण                                                      |
| ---------- | ---------- | ---------------------------------------------------------- |
| `code`     | `int`      | स्थिति कोड                                                 |
| `error`    | `स्ट्रिंग` | त्रुटि विवरण फ़ील्ड                                        |
| `max_step` | `float`    | वह न्यूनतम संभव मान जिससे आप वर्तमान में कीमत घटा सकते हैं |

```
{
    "error":"exceeded_max_step",
    "max_step":0.0000032,
    "code":6
}
```

**इनपुट 2 (वैध कीमत में कमी):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000320
}' 'https://api.clore.ai/v1/set_spot_price'
```

**संभव आउटपुट 2 (वैध कीमत में कमी):**

```
{
    "code": 0
}
```

**इनपुट 3 (इनपुट 2 भेजने के बाद कीमत और भी कम करें):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000220
}' 'https://api.clore.ai/v1/set_spot_price
```

**संभव आउटपुट 3 (इनपुट 2 भेजने के बाद कीमत और भी कम करें):**\
आप स्पॉट कीमत 600 सेकंड में एक बार घटा सकते हैं

| फ़ील्ड             | प्रकार     | विवरण                                         |
| ------------------ | ---------- | --------------------------------------------- |
| `code`             | `int`      | स्थिति कोड                                    |
| `error`            | `स्ट्रिंग` | त्रुटि विवरण फ़ील्ड                           |
| `time_to_lowering` | `float`    | कीमत घटाने की अगली संभावना तक शेष समय (सेकंड) |

```
{
    "error":"can_lower_every_600_seconds",
    "time_to_lowering":513,
    "code":6
}
```

#### 9. `cancel_order` <a href="#id-9-cancel_order" id="id-9-cancel_order"></a>

**के बारे में**

एक सक्रिय ऑर्डर या स्पॉट प्रस्ताव रद्द करें

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड  | प्रकार     | अनिवार्य | विवरण                                                                                                                            |
| ------- | ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `id`    | `int`      | हाँ      | अद्वितीय ऑर्डर/प्रस्ताव ID                                                                                                       |
| `issue` | `स्ट्रिंग` | नहीं     | यदि आपको सर्वर के साथ कोई समस्या आई है, तो आप उन्हें यहाँ रिपोर्ट कर सकते हैं [clore.ai](http://clore.ai/) टीम, अधिकतम 2048 वर्ण |

**आउटपुट**

| फ़ील्ड | प्रकार | विवरण      |
| ------ | ------ | ---------- |
| `code` | `int`  | स्थिति कोड |

**उदाहरण**

ऑर्डर/प्रस्ताव रद्द करें

**इनपुट:**\
इस उदाहरण में हम GPU #1 के साथ समस्याएँ रिपोर्ट कर रहे हैं, यदि आपको कोई समस्या नहीं है, तो issue फ़ील्ड शामिल न करें.\
आप text फ़ील्ड में कोई भी संदेश लिख सकते हैं और हम उसकी जाँच करेंगे

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"GPU #1 Was overheating and throttling"
}' 'https://api.clore.ai/v1/cancel_order'
```

**आउटपुट:**

```
{
  "code": 0
}
```

#### 10. `create_order` <a href="#id-10-create_order" id="id-10-create_order"></a>

**के बारे में**

आप इस एंडपॉइंट के साथ स्पॉट प्रस्ताव या ऑन-डिमांड ऑर्डर बना सकते हैं

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड                 | प्रकार     | अनिवार्य       | विवरण                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ---------------------- | ---------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency`             | `स्ट्रिंग` | हाँ            | मुद्रा का नाम                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| `image`                | `स्ट्रिंग` | हाँ            | dockerhub से वैध इमेज                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `renting_server`       | `int`      | हाँ            | जिस सर्वर को आप किराये पर लेना चाहते हैं उसका ID                                                                                                                                                                                                                                                                                                                                                                                                        |
| `type`                 | `स्ट्रिंग` | हाँ            | `ऑन-डिमांड` या `spot`                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `spotprice`            | `float`    | निर्भर करता है | स्पॉट बाज़ार में प्रति दिन प्रस्तावित कीमत, स्पॉट ऑर्डर बनाते समय आवश्यक                                                                                                                                                                                                                                                                                                                                                                                |
| `ports`                | `ऑब्जेक्ट` | नहीं           | पोर्ट फ़ॉरवर्डिंग कॉन्फ़िगरेशन, अधिकतम 5 रिकॉर्ड                                                                                                                                                                                                                                                                                                                                                                                                        |
| `env`                  | `ऑब्जेक्ट` | नहीं           | <p>पर्यावरण चर, स्ट्रिंग में बदलने पर कुल 12288 वर्णों तक सीमित.<br>चर का नाम - अधिकतम 128 प्रतीक, इसमें नहीं होना चाहिए <code>-</code><br>चर का मान - अधिकतम 1536 प्रतीक<br>केवल पहले 30 वैध चर रखे जाते हैं; अतिरिक्त को चुपचाप हटा दिया जाता है</p>                                                                                                                                                                                                  |
| `jupyter_token`        | `स्ट्रिंग` | नहीं           | Jupyter नोटबुक वाली इमेज के लिए Jupyter टोकन, अधिकतम 32 वर्ण \*                                                                                                                                                                                                                                                                                                                                                                                         |
| `ssh_key`              | `स्ट्रिंग` | नहीं           | SSH वाली इमेज के लिए SSH कुंजी, अधिकतम 3072 वर्ण \*                                                                                                                                                                                                                                                                                                                                                                                                     |
| `ssh_password`         | `स्ट्रिंग` | नहीं           | SSH वाली इमेज के लिए SSH पासवर्ड, अधिकतम 32 वर्ण \*                                                                                                                                                                                                                                                                                                                                                                                                     |
| `command`              | `स्ट्रिंग` | नहीं           | ऑर्डर बनाने के बाद सर्वर पर कमांड चलाई जाएगी                                                                                                                                                                                                                                                                                                                                                                                                            |
| `required_price`       | `float`    | नहीं           | ऑर्डर शुरू करने के लिए आप जो कीमत चाहते हैं उसे निर्दिष्ट करें; यदि मशीन मालिक कीमत बदल देता है, तो ऑर्डर शुरू नहीं होगा (केवल ऑन-डिमांड)                                                                                                                                                                                                                                                                                                               |
| `gpu_count`            | `int`      | नहीं           | उन सर्वरों पर किराये के लिए GPUs की संख्या जो समर्थन करते हैं [आंशिक किराया](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-renters/partial-gpu-rental.md). पूरे रिग को किराये पर लेने के लिए इसे छोड़ दें। केवल ऑन-डिमांड, केवल समरूप रिग                                                                                                                                                                                                          |
| `gpu_indices`          | `[]int`    | नहीं           | किराये पर लेने के लिए 0-आधारित GPU स्लॉट इंडेक्स; लंबाई बराबर होनी चाहिए `gpu_count`. से खाली स्लॉट लें `partial_gpu_rental.free_indices`. बैकएंड को स्वतः खाली GPUs चुनने देने के लिए इसे छोड़ दें                                                                                                                                                                                                                                                     |
| `autossh_entrypoint`   | `bool`     | नहीं           | clore.ai entrypoint का उपयोग करें, जो स्वचालित रूप से SSH सर्वर और कस्टम `/root/onstart.sh` स्क्रिप्ट                                                                                                                                                                                                                                                                                                                                                   |
| `rental_hours`         | `int`      | नहीं           | केवल ऑन-डिमांड। आप मशीन को कितने समय तक चाहते हैं, पूरे घंटों में 1 से 3000 तक (प्लैटफ़ॉर्म अधिकतम), ऑर्डर बनने के समय से गिना गया। बिना सीमा का अनुरोध करने के लिए इसे छोड़ दें: तब ऑर्डर सर्वर के `mrl` जब तक `auto_renew` चालू है, जिस स्थिति में यह तब तक चलता है जब तक आप रद्द नहीं करते। सर्वर की `mrl` आवश्यक `auto_renew: true`; उससे कम या बराबर मान ऑर्डर को उतने घंटों बाद समाप्त करता है। स्पॉट ऑर्डरों पर अनदेखा किया जाता है              |
| `auto_renew`           | `bool`     | नहीं           | केवल ऑन-डिमांड। जब सर्वर की अधिकतम किराये की लंबाई पूरी हो जाती है, तो ऑर्डर को उसी कंटेनर पर सर्वर की वर्तमान कीमत पर नवीनीकृत करें, बशर्ते वह कीमत इससे कम या बराबर हो `auto_renew_max_price`, जब तक `rental_hours` का उपयोग किया जाता है, या जब तक आप रद्द नहीं करते जब `rental_hours` छोड़ दिया गया हो। नवीनीकरण पर कोई निर्माण शुल्क नहीं लिया जाता। स्पॉट ऑर्डरों पर और उन सर्वरों पर अस्वीकार किया जाता है जिनका `auto_renew_allowed` है `false` |
| `auto_renew_max_price` | `float`    | निर्भर करता है | जब आवश्यक हो `auto_renew` है `true`. ऑर्डर की मुद्रा में प्रति-दिन मूल्य सीमा, 0 से ऊपर और उस मुद्रा के लिए बाज़ार की अधिकतम कीमत से अधिक नहीं (0.1 BTC, 5,000,000 CLORE, 10,000 USD)। प्रत्येक नवीनीकरण पर इसकी तुलना सर्वर की प्रति दिन कीमत से की जाती है, जिसे इसमें स्केल किया गया है `gpu_count` आंशिक किराये पर                                                                                                                                  |

\* तारे से चिह्नित फ़ील्ड में आप केवल इस regexp समूह के वर्ण दर्ज कर सकते हैं `/^[a-zA-Z0-9\s-=.@+/]+$/`

**आउटपुट**

| फ़ील्ड  | प्रकार     | विवरण                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`  | `int`      | स्थिति कोड                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `error` | `स्ट्रिंग` | कोड के साथ उपस्थित `6` (HTTP 200) जब ऑर्डर अस्वीकार किया जाता है। किराये की अवधि और स्वतः-नवीनीकरण अस्वीकृतियाँ: `invalid_rental_hours` (1 से 3000 तक की पूर्ण संख्या नहीं, या `null`), `rental_hours_exceeds_mrl` (सर्वर के `mrl` बिना `auto_renew: true`), `invalid_auto_renew` (`auto_renew` बूलियन नहीं है, या यह `true` एक सकारात्मक के बिना `auto_renew_max_price`, या मुद्रा के लिए बाज़ार की अधिकतम कीमत से ऊपर के साथ), `auto_renew_not_supported` (`auto_renew: true` स्पॉट ऑर्डर पर), `auto_renew_not_allowed` (सर्वर स्वतः-नवीनीकरण की अनुमति नहीं देता)। स्पॉट बिड अस्वीकृतियाँ नीचे वर्णित हैं |

> **सर्वर के न्यूनतम से नीचे की स्पॉट बिड** वर्तमान न्यूनतम शामिल करके अस्वीकार की जाती हैं, इसलिए आप तुरंत पुनः प्रयास कर सकते हैं:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> न्यूनतम लगभग हर 10 मिनट में लाइव कॉइन दरों से पुनर्गणना किया जाता है, इसलिए मार्केटप्लेस सूची से पढ़ी गई कीमत थोड़ी पुरानी हो सकती है — हमेशा लौटाए गए `min_price` को पुनः प्रयास के लिए उपयोग करें।
>
> **जब सर्वर पर पहले से उसी मुद्रा में स्पॉट बिडें मौजूद हों**, तो नई बिड शीर्ष बिड से कम से कम 1% ऊपर होनी चाहिए (मुद्रा की सटीकता तक ऊपर गोल की गई, मूल्य सीमा पर सीमित)। कम बिड निम्नतम स्वीकृत कीमत के साथ अस्वीकार की जाती है:
>
> ```
> { "error": "below_min_raise_step", "min_price": 0.00000425, "code": 6 }
> ```

**उदाहरण**

**इनपुट 1 (स्पॉट प्रस्ताव बनाएँ):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"spot",
    "spotprice":0.000001,
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**आउटपुट 1 (स्पॉट ऑफर बनाएं):**

```
{
  "code":0
}
```

**इनपुट 2 (ऑन-डिमांड ऑर्डर बनाएं):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"on-demand",
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**आउटपुट 2 (ऑन-डिमांड ऑर्डर बनाएं):**

```
{
  "code":0
}
```

**इनपुट 3 (ऑटो-नवीनीकरण के साथ 48 घंटे के लिए ऑन-डिमांड ऑर्डर):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"CLORE-Blockchain",
    "image":"cloreai/jupyter:ubuntu24.04-v2",
    "renting_server":6,
    "type":"on-demand",
    "rental_hours":48,
    "auto_renew":true,
    "auto_renew_max_price":250
}' 'https://api.clore.ai/v1/create_order'
```

**आउटपुट 3 (ऑटो-नवीनीकरण के साथ 48 घंटे के लिए ऑन-डिमांड ऑर्डर):**

```
{
  "code":0
}
```

24 घंटे वाले सर्वर पर `mrl` पहला कार्यकाल 24 घंटे का होता है। इसके अंत में ऑर्डर उस समय सर्वर की कीमत पर अगले 24 घंटों के लिए नवीनीकृत होता है, यदि वह प्रति दिन 250 CLORE पर या उससे कम है, फिर 48 अनुरोधित घंटे समाप्त हो जाने के कारण समाप्त हो जाता है। के साथ `auto_renew` चालू करने पर, इसे छोड़ देने पर `rental_hours` यह तब तक नवीनीकृत होता रहता है जब तक आप रद्द नहीं करते। के बिना `auto_renew`, वही `rental_hours` उस सर्वर पर चालू करने का अनुरोध अस्वीकार कर दिया जाता है:

```
{ "error": "rental_hours_exceeds_mrl", "code": 6 }
```

#### 11. `renter_fees` <a href="#id-11-renter_fees" id="id-11-renter_fees"></a>

**के बारे में**

वर्तमान शुल्क कॉन्फ़िगरेशन प्राप्त करें: बेस रेंटर शुल्क, PoH शुल्क कमी सेटिंग्स, ऑर्डर निर्माण शुल्क, और आपका PoH बैलेंस

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                             | प्रकार     | विवरण                                                |
| ---------------------------------- | ---------- | ---------------------------------------------------- |
| `code`                             | `int`      | स्थिति कोड                                           |
| `renter_fees.on_demand`            | `ऑब्जेक्ट` | ऑन-डिमांड ऑर्डरों के लिए प्रति मुद्रा आधार शुल्क (%) |
| `renter_fees.spot`                 | `ऑब्जेक्ट` | स्पॉट ऑर्डरों के लिए प्रति मुद्रा आधार शुल्क (%)     |
| `poh_config.max_reduction_percent` | `int`      | PoH के माध्यम से अधिकतम आधार-शुल्क कमी (%)           |
| `poh_config.max_poh_amount`        | `int`      | वह PoH बैलेंस जिस पर अधिकतम कमी प्राप्त होती है      |
| `creation_fees.on_demand`          | `ऑब्जेक्ट` | प्रति मुद्रा ऑर्डर निर्माण शुल्क                     |
| `creation_fees.spot`               | `ऑब्जेक्ट` | स्पॉट ऑर्डर निर्माण शुल्क प्रति मुद्रा               |
| `poh_balance`                      | `float`    | आपका PoH CLORE बैलेंस                                |

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```

**आउटपुट:**

```
{
  "renter_fees": {
    "on_demand": {
      "base": { "bitcoin": 5, "CLORE-Blockchain": 5, "USD-Blockchain": 5 }
    },
    "spot": {
      "base": { "bitcoin": 1.25, "CLORE-Blockchain": 1.25, "USD-Blockchain": 1.25 }
    }
  },
  "poh_config": { "max_reduction_percent": 50, "max_poh_amount": 2000000 },
  "creation_fees": {
    "on_demand": { "bitcoin": 3e-7, "CLORE-Blockchain": 0.5, "USD-Blockchain": 0.1 },
    "spot": { "bitcoin": 1e-7, "CLORE-Blockchain": 0.05, "USD-Blockchain": 0.005 }
  },
  "poh_balance": 5000,
  "code": 0
}
```

#### 12. `cancel_orders` <a href="#id-12-cancel_orders" id="id-12-cancel_orders"></a>

**के बारे में**

एक बार में कई ऑर्डर रद्द करें (प्रति अनुरोध अधिकतम 256)

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड      | प्रकार  | अनिवार्य | विवरण                                   |
| ----------- | ------- | -------- | --------------------------------------- |
| `order_ids` | `[]int` | हाँ      | रद्द करने के लिए ऑर्डर आईडी, अधिकतम 256 |

**आउटपुट**

| फ़ील्ड             | प्रकार  | विवरण                                       |
| ------------------ | ------- | ------------------------------------------- |
| `code`             | `int`   | स्थिति कोड                                  |
| `failed_to_cancel` | `[]int` | वे ऑर्डर आईडी जिन्हें रद्द नहीं किया जा सका |

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```

**आउटपुट:**

```
{
  "failed_to_cancel": [],
  "code": 0
}
```

#### 13. `poh_balance` <a href="#id-13-poh_balance" id="id-13-poh_balance"></a>

**के बारे में**

अपने Proof of Holding बैलेंस प्राप्त करें: आइटम, कुल, और PoH Marketplace ऑफ़र राशियाँ

**हेडर**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                                        | प्रकार     | विवरण                                          |
| --------------------------------------------- | ---------- | ---------------------------------------------- |
| `code`                                        | `int`      | स्थिति कोड                                     |
| `items`                                       | `[]object` | अलग-अलग बैलेंस वाले आपके PoH आइटम              |
| `balance.total`                               | `float`    | सभी आइटमों का कुल PoH बैलेंस                   |
| `balance.free_amount`                         | `float`    | ऑफ़रों में प्रतिबद्ध न किया गया PoH बैलेंस     |
| `balance.reward_amount`                       | `float`    | इनाम के लिए पात्र बैलेंस                       |
| `balance.offers.rented_amount`                | `float`    | अन्य उपयोगकर्ताओं को किराये पर दिया गया मात्रा |
| `balance.offers.rented_on_marketplace_amount` | `float`    | PoH Marketplace पर सूचीबद्ध मात्रा             |
| `balance.offers.leased_amount`                | `float`    | अन्य उपयोगकर्ताओं से लिया गया लीज़ पर मात्रा   |

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```

**आउटपुट:**

```
{
  "items": [ { "balance": 5000 } ],
  "balance": {
    "total": 5000,
    "free_amount": 4000,
    "reward_amount": 5000,
    "offers": {
      "rented_amount": 0,
      "rented_on_marketplace_amount": 1000,
      "rented_finished_amount": 0,
      "leased_amount": 0
    }
  },
  "code": 0
}
```

#### 14. `server-config.json` <a href="#id-14-server-config-json" id="id-14-server-config-json"></a>

**के बारे में**

स्थिर API कॉन्फ़िगरेशन डेटा प्राप्त करें। प्रमाणीकरण की आवश्यकता नहीं है

**इनपुट:**

```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```

#### 15. `get_relay` <a href="#id-15-get_relay" id="id-15-get_relay"></a>

**के बारे में**

अपने पहचाने गए देश के लिए TCP फ़ॉरवर्डिंग रिले नोड्स प्राप्त करें। प्रमाणीकरण की आवश्यकता नहीं है

**आउटपुट**

| फ़ील्ड    | प्रकार     | विवरण              |
| --------- | ---------- | ------------------ |
| `code`    | `int`      | स्थिति कोड         |
| `country` | `स्ट्रिंग` | पहचाना गया देश कोड |
| `nodes`   | `ऑब्जेक्ट` | उपलब्ध रिले नोड्स  |

**इनपुट:**

```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```

#### 16. `चल रहे ऑर्डर पर इन्हें बदलने के लिए, और` <a href="#id-16-set_order_auto_renew" id="id-16-set_order_auto_renew"></a>

**के बारे में**

अपने सक्रिय ऑन-डिमांड ऑर्डर की अनुरोधित किराये की अवधि, ऑटो-नवीनीकरण और उसके मूल्य-सीमा को बदलें। केवल वही फ़ील्ड भेजें जिन्हें आप बदलना चाहते हैं; छोड़ा गया फ़ील्ड अपना वर्तमान मान बनाए रखता है। केवल POST; GET उत्तर देता है code `4`.

* फिर वर्तमान अवधि अनुरोधित समाप्ति पर या `term_start + term_mrl`जो भी पहले हो, और अब से 60 सेकंड से पहले कभी नहीं। `mrl` और `term_end` मेल खाने के लिए बदलें। इसके आगे चलना `term_start + term_mrl` की आवश्यकता है `auto_renew`, और अवधि के अंत में नवीनीकरण इसे फिर से मूल्यांकित करता है।
* अनुरोध को आगे बढ़ाना `term_start + term_mrl` केवल तब संभव है जब `auto_renew` चालू हो; अन्यथा इसे के साथ अस्वीकार कर दिया जाता है `rental_hours_exceeds_mrl`. एक सेट को बदलना `rental_hours` से `null` जबकि `auto_renew` बंद रहता है, उसे लंबाई बढ़ाना माना जाता है, और ऐसा संपादन जो स्विच करता है `auto_renew` नए भेजते समय बंद `rental_hours` जो इससे आगे समाप्त होते हैं `term_start + term_mrl` इसी तरह अस्वीकार कर दिया जाता है।
* स्विच किए बिना अनुरोध को छोटा करना `auto_renew` को उसी परिवर्तन में बंद करना हमेशा स्वीकार किया जाता है, और स्विच करना भी `auto_renew` नए घंटों के बिना या के साथ बंद करना `rental_hours: null`. यदि नए `rental_hours` पहले ही उपयोग हो चुके हैं, तो ऑर्डर परिवर्तन के लगभग एक मिनट बाद समाप्त हो जाता है। किराये को तुरंत रोकने के लिए, उपयोग करें [`cancel_order`](#id-9-cancel_order).
* `rental_hours: null` अनुरोधित सीमा हटा देता है: के साथ `auto_renew` चालू होने पर, ऑर्डर तब तक चलता रहता है जब तक आप रद्द नहीं करते।
* किसी अवधि के समाप्त होने से 60 सेकंड पहले से लेकर अवधि के नवीनीकृत होने या ऑर्डर के समाप्त होने तक, परिवर्तन को के साथ अस्वीकार किया जाता है `renewal_in_progress`. ऑर्डर को फिर से इसके साथ पढ़ें [`my_orders`](#id-5-my_orders) और पुनः प्रयास करें।
* ऑटो-नवीनीकरण जारी होने से पहले बनाए गए ऑर्डर पर, पहला परिवर्तन सेट करता है `term_start` को निर्माण समय पर और `term_mrl` को ऑर्डर के `mrl`, इसलिए बिना `auto_renew` इसके, यह अपनी मूल समाप्ति से आगे नहीं चल सकता।

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड                 | प्रकार          | अनिवार्य       | विवरण                                                                                                                                                                                                                                                           |
| ---------------------- | --------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `order_id`             | `int`           | हाँ            | अद्वितीय ऑर्डर ID                                                                                                                                                                                                                                               |
| `rental_hours`         | `int` \| `null` | नहीं           | नया अनुरोधित लंबाई पूर्ण घंटों में (1 से 3000), ऑर्डर के निर्माण से गिनी जाती है। `null` अनुरोधित सीमा हटा देता है। वर्तमान मान बनाए रखने के लिए इसे छोड़ दें                                                                                                   |
| `auto_renew`           | `bool`          | नहीं           | वर्तमान अवधि समाप्त होने पर होस्ट की वर्तमान कीमत पर नवीनीकरण करें। वर्तमान मान बनाए रखने के लिए इसे छोड़ दें। इसे चालू करना तब अस्वीकार किया जाता है जब सर्वर की `auto_renew_allowed` है `false`                                                               |
| `auto_renew_max_price` | `float`         | निर्भर करता है | ऑर्डर की मुद्रा में प्रति-दिन मूल्य सीमा, 0 से अधिक और उस मुद्रा के लिए मार्केटप्लेस की अधिकतम कीमत से अधिक नहीं। आवश्यक जब यह परिवर्तन `auto_renew` को चालू करता है और ऑर्डर के पास अभी तक कोई सीमा नहीं है; अन्यथा वर्तमान सीमा बनाए रखने के लिए इसे छोड़ दें |

**आउटपुट**

| फ़ील्ड  | प्रकार     | विवरण                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`  | `int`      | स्थिति कोड। `2` (HTTP 400) जब बॉडी का प्रकार गलत हो, उदाहरण के लिए अनुपस्थित या गैर-पूर्णांक `order_id`, `rental_hours` जो न तो पूर्ण संख्या है और न ही `null`, एक गैर-बूलियन `auto_renew` या एक गैर-संख्यात्मक `auto_renew_max_price`; नीचे दी गई किसी भी त्रुटि से पहले इसकी जांच की जाती है                                                                                                                                                                                                                                                                                                                                                                                               |
| `error` | `स्ट्रिंग` | कोड के साथ उपस्थित `6` (HTTP 200): `you_dont_own_this_order` (ऑर्डर मौजूद नहीं है या आपका नहीं है), `order_not_active` (एक स्पॉट या बंद ऑर्डर, रद्द किया जा रहा ऑर्डर, या वह जो परिवर्तन सहेजे जाने के दौरान समाप्त हो गया), `renewal_in_progress` (वर्तमान अवधि 60 सेकंड के भीतर समाप्त हो जाती है, या परिवर्तन सहेजे जाने के दौरान ऑर्डर बदल गया; ऑर्डर को फिर से पढ़ें और पुनः प्रयास करें), `invalid_rental_hours` (1 से कम या 3000 से अधिक), `rental_hours_exceeds_mrl` (ऊपर दिए गए नियम देखें), `invalid_auto_renew` (`auto_renew` वैध मूल्य सीमा के बिना चालू हो जाता है), `auto_renew_not_allowed` (परिवर्तन `auto_renew` को चालू करता है और सर्वर ऑटो-नवीनीकरण की अनुमति नहीं देता) |

**उदाहरण**

**इनपुट 1 (रद्द होने तक नवीनीकरण जारी रखें):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "rental_hours":null,
    "auto_renew":true,
    "auto_renew_max_price":30
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**आउटपुट 1 (रद्द होने तक नवीनीकरण जारी रखें):**

```
{
  "code": 0
}
```

**इनपुट 2 (नवीनीकरण रोकें, ऑर्डर अपनी वर्तमान अवधि के साथ समाप्त होता है):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345,
    "auto_renew":false
}' 'https://api.clore.ai/v1/set_order_auto_renew'
```

**आउटपुट 2 (नवीनीकरण रोकें, ऑर्डर अपनी वर्तमान अवधि के साथ समाप्त होता है):**

```
{
  "code": 0
}
```

किसी अवधि के अंतिम 60 सेकंड में भेजे जाने पर, वही अनुरोध तब तक अस्वीकार किया जाता है जब तक ऑर्डर नवीनीकृत या समाप्त नहीं हो जाता:

```
{ "error": "renewal_in_progress", "code": 6 }
```

#### 17. `order_renewals` <a href="#id-17-order_renewals" id="id-17-order_renewals"></a>

**के बारे में**

अपने ऑर्डर का नवीनीकरण इतिहास प्राप्त करें: अवधि समाप्त होने पर लिए गए प्रत्येक नवीनीकरण निर्णय के लिए एक पंक्ति, नवीनीकृत या अस्वीकृत, नवीनतम पहले, अधिकतम 1000 पंक्तियाँ। जो ऑर्डर कभी नवीनीकरण निर्णय तक नहीं पहुँचा, वह एक खाली सूची लौटाता है, और वह समाप्ति जिस पर कोई ऑर्डर अपने अनुरोधित घंटों के उपयोग हो जाने के कारण रुकता है, कोई पंक्ति नहीं छोड़ती। केवल POST; GET का उत्तर code `4`.

**हेडर**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड     | प्रकार | अनिवार्य | विवरण             |
| ---------- | ------ | -------- | ----------------- |
| `order_id` | `int`  | हाँ      | अद्वितीय ऑर्डर ID |

**आउटपुट**

| फ़ील्ड                     | प्रकार     | विवरण                                                                                                                                                                                                    |
| -------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `code`                     | `int`      | स्थिति कोड। `2` (HTTP 400) जब `order_id` अनुपस्थित है या पूर्णांक नहीं है                                                                                                                                |
| `error`                    | `स्ट्रिंग` | `you_dont_own_this_order` कोड के साथ `6` (HTTP 200) जब ऑर्डर मौजूद नहीं है या आपका नहीं है                                                                                                               |
| `renewals`                 | `[]object` | नवीनीकरण निर्णय, नवीनतम पहले; केवल सफलता पर मौजूद                                                                                                                                                        |
| `renewals[x].order_id`     | `int`      | अद्वितीय ऑर्डर ID                                                                                                                                                                                        |
| `renewals[x].renewal_no`   | `int`      | यह नवीनीकरण क्रमांक, या होता, ऑर्डर के नवीनीकरणों में, 1 से गिनते हुए                                                                                                                                    |
| `renewals[x].outcome`      | `स्ट्रिंग` | `नवीनीकृत` या `अस्वीकृत`                                                                                                                                                                                 |
| `renewals[x].reason`       | `स्ट्रिंग` | केवल अस्वीकृत पंक्तियाँ: `price_above_cap`, `server_unlisted`, `host_disallowed`, `server_reserved` या `insufficient_balance` (देखें `orders[x].auto_renew_declined` में [`my_orders`](#id-5-my_orders)) |
| `renewals[x].decided_at`   | `int`      | निर्णय का UNIX समय, जब अवधि समाप्त हो चुकी थी तब लिया गया                                                                                                                                                |
| `renewals[x].applied_at`   | `int`      | वह UNIX समय जब नवीनीकरण के प्रभावी होने की पुष्टि की गई। अस्वीकृति पर और उस नवीनीकरण निर्णय पर अनुपस्थित जो पुष्टि नहीं हुआ; निर्णय लागू न रह सकता है जब ऑर्डर उसी क्षण रद्द या बदला गया हो              |
| `renewals[x].old_price`    | `float`    | समाप्त हुई अवधि की प्रति-दिन कीमत                                                                                                                                                                        |
| `renewals[x].new_price`    | `float`    | नई अवधि की प्रति-दिन कीमत, या अस्वीकृति पर होस्ट की वह कीमत जिसे अस्वीकार किया गया; जब कोई कीमत गणना नहीं की जा सकी तब अनुपस्थित                                                                         |
| `renewals[x].cap`          | `float`    | निर्णय लेते समय आपकी प्रति-दिन मूल्य सीमा                                                                                                                                                                |
| `renewals[x].term_seconds` | `int`      | नई अवधि की लंबाई सेकंडों में; `0` अस्वीकृति पर                                                                                                                                                           |
| `renewals[x].term_start`   | `int`      | नई अवधि शुरू होने का UNIX समय (पिछली अवधि का अंत); अस्वीकृति पर, समाप्त हुई अवधि की शुरुआत                                                                                                               |
| `renewals[x].term_end`     | `int`      | नई अवधि समाप्त होने का UNIX समय; अस्वीकृति पर, समाप्त हुई अवधि का अंत                                                                                                                                    |

**उदाहरण**

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":12345
}' 'https://api.clore.ai/v1/order_renewals'
```

**आउटपुट:**

इस उदाहरण में ऑर्डर 24 प्रति दिन पर एक बार नवीनीकृत हुआ, अपनी 30 की सीमा के भीतर। उस अवधि के अंत में होस्ट की कीमत 36 थी, जो सीमा से ऊपर थी, इसलिए नवीनीकरण अस्वीकार कर दिया गया और ऑर्डर उसी अवधि के साथ समाप्त हुआ।

```
{
  "renewals": [
    {
      "order_id": 12345,
      "renewal_no": 2,
      "outcome": "declined",
      "reason": "price_above_cap",
      "decided_at": 1792209661,
      "old_price": 24,
      "new_price": 36,
      "cap": 30,
      "term_seconds": 0,
      "term_start": 1792188060,
      "term_end": 1792209660
    },
    {
      "order_id": 12345,
      "renewal_no": 1,
      "outcome": "renewed",
      "decided_at": 1792188061,
      "applied_at": 1792188061,
      "old_price": 20,
      "new_price": 24,
      "cap": 30,
      "term_seconds": 21600,
      "term_start": 1792188060,
      "term_end": 1792209660
    }
  ],
  "code": 0
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-hosts/api.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
