# API

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

<div data-full-width="true"><figure><img src="/files/e83711806ceff5b412cdd6790c36f5cd5844e185" 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`  | सामान्य                                   |
| `1`  | डेटाबेस त्रुटि                            |
| `2`  | अमान्य इनपुट डेटा                         |
| `3`  | अमान्य API टोकन                           |
| `4`  | अमान्य एंडपॉइंट                           |
| `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>

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

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

**हेडर**

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

**आउटपुट**

| फ़ील्ड                        | प्रकार     | विवरण                                                       |
| ----------------------------- | ---------- | ----------------------------------------------------------- |
| `code`                        | `int`      | स्थिति कोड                                                  |
| `सीमा`                        | `int`      | अधिकतम सर्वरों की संख्या जो आप मालिक हो सकते हैं            |
| `servers`                     | `[]string` | सर्वरों की सरणी                                             |
| `servers[x].name`             | `स्ट्रिंग` | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                        |
| `servers[x].connected`        | `स्ट्रिंग` | क्या सर्वर कभी जुड़ा हुआ था to [clore.ai](http://clore.ai/) |
| `servers[x].visibility`       | `स्ट्रिंग` | मार्केटप्लेस पर दृश्यता                                     |
| `servers[x].pricing`          | `[]string` | मांग पर कीमत/दिन                                            |
| `servers[x].online`           | `बूल`      | क्या सर्वर ऑनलाइन है                                        |
| `servers[x].min_spot_pricing` | `[]string` | स्पॉट मार्केट के लिए न्यूनतम किराया/दिन                     |
| `servers[x].init_token`       | `स्ट्रिंग` | प्रारंभिककरण टोकन                                           |
| `servers[x].specs`            | `[]string` | सर्वर विनिर्देश                                             |

**उदाहरण**

**इनपुट:**

```
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 },
      "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 },
      "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 अभी लागू नहीं हुआ**

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

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

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

**हेडर**

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

**बॉडी**

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

**आउटपुट**

| फ़ील्ड                  | प्रकार     | विवरण                                                                           |
| ----------------------- | ---------- | ------------------------------------------------------------------------------- |
| `code`                  | `int`      | स्थिति कोड                                                                      |
| `creation_completed`    | `बूल`      | क्या सर्वर निर्माण पूरा है                                                      |
| `config`                | `[]string` | सर्वर का कॉन्फ़िग                                                               |
| `config.name`           | `स्ट्रिंग` | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                            |
| `config.connected`      | `बूल`      | क्या सर्वर कभी जुड़ा हुआ था to [clore.ai](http://clore.ai/)                     |
| `config.visibility`     | `स्ट्रिंग` | मार्केटप्लेस पर दृश्यता                                                         |
| `config.pricing`        | `[]string` | मांग पर कीमत/दिन                                                                |
| `config.spot_pricing`   | `[]string` | स्पॉट मार्केट के लिए न्यूनतम किराया/दिन                                         |
| `config.mrl`            | `int`      | अधिकतम किराये की अवधि घंटों में                                                 |
| `config.online`         | `बूल`      | क्या सर्वर ऑनलाइन है                                                            |
| `config.initialized`    | `बूल`      | क्या सर्वर कभी जुड़ा हुआ था to [clore.ai](http://clore.ai/)                     |
| `config.id`             | `int`      | अद्वितीय सर्वर ID                                                               |
| `config.rental_status`  | `int`      | 0 - किराए पर नहीं \| 1 - स्पॉट मार्केट पर किराए पर \| 2 - ऑन डिमांड पर किराए पर |
| `config.specs`          | `[]string` | सर्वर विनिर्देश                                                                 |
| `config.background_job` | `[]string` | नॉन-रेंटेड होने पर बैकग्राउंड जॉब                                               |

**उदाहरण**

**इनपुट:**

```
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,
    "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 अभी लागू नहीं हुआ**

#### 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].price.on_demand` | `[]string` | मांग पर कीमत प्रति दिन                                                                                            |
| `servers[x].spot`            | `[]string` | स्पॉट मार्केट के लिए न्यूनतम कीमत प्रति दिन                                                                       |
| `servers[x].rented`          | `बूल`      | क्या सर्वर मांग पर किराए पर है                                                                                    |
| `servers[x].specs`           | `[]string` | सर्वर विनिर्देश                                                                                                   |

**उदाहरण**

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

**इनपुट:**

```
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,
      "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` | `बूल`  | नहीं     | पूर्ण (समाप्त) ऑर्डर लौटाएं |

**आउटपुट**

| फ़ील्ड                   | प्रकार     | विवरण                                                         |
| ------------------------ | ---------- | ------------------------------------------------------------- |
| `code`                   | `int`      | स्थिति कोड                                                    |
| `सीमा`                   | `int`      | सक्रिय ऑर्डरों की अधिकतम संख्या                               |
| `orders`                 | `[]string` | ऑर्डरों की सरणी                                               |
| `orders[x].id`           | `int`      | अद्वितीय ऑर्डर ID                                             |
| `orders[x].fee`          | `फ्लोट`    | फीस (%) जो भुगतान की जाती है to [clore.ai](http://clore.ai/)  |
| `orders[x].creation_fee` | `फ्लोट`    | निर्माण शुल्क जो भुगतान किया गया [clore.ai](http://clore.ai/) |
| `orders[x].price`        | `फ्लोट`    | ऑर्डर कीमत (लागत) प्रति दिन                                   |
| `orders[x].mrl`          | `int`      | ऑर्डर की अधिकतम किराये की अवधि सेकंड में                      |
| `orders[x].image`        | `स्ट्रिंग` | प्रयोजित डॉकर इमेज                                            |
| `orders[x].currency`     | `स्ट्रिंग` | बिलिंग के लिए प्रयुक्त मुद्रा                                 |
| `orders[x].spend`        | `फ्लोट`    | ऑर्डर पर खर्च की गई राशि                                      |
| `orders[x].ct`           | `int`      | निर्माण समय (UNIX समय)                                        |
| `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`         | `बूल`      | इस बात का संकेत कि यह स्पॉट ऑर्डर है                          |
| `orders[x].expired`      | `बूल`      | इस बात का संकेत कि ऑर्डर समाप्त हो चुका है                    |

**इनपुट:**

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

**आउटपुट:**

```
{
  "orders": [
    {
      "id": 38,
      "fee": 5,
      "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"
    },{
      "id": 36,
      "fee": 2.5,
      "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,
      "expired": true,
      "tcp_ports": []
    }
  ],
  "limit": 13,
  "code": 0
}
```

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

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

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

**हेडर**

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

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

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

**आउटपुट**

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

**इनपुट:**

```
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
      }
    ],
    "server": {
      "min_pricing": {
        "bitcoin": 0.000001
      },
      "mrl": 262800,
      "visibility": "public",
      "online": true
    }
  },
  "exists": true,
  "code": 0
}
```

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

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

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

**हेडर**

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

**बॉडी**

| फ़ील्ड      | प्रकार     | अनिवार्य | विवरण                                      |
| ----------- | ---------- | -------- | ------------------------------------------ |
| `name`      | `स्ट्रिंग` | हाँ      | उपयोगकर्ता द्वारा चुना गया सर्वर नाम       |
| `उपलब्धता`  | `बूल`      | हाँ      | क्या सर्वर किराए पर दिया जा सकता है        |
| `mrl`       | `int`      | हाँ      | सर्वर की अधिकतम किराये की अवधि             |
| `on_demand` | `फ्लोट`    | हाँ      | आपके सर्वर के लिए ऑन-डिमांड कीमत प्रति दिन |
| `spot`      | `फ्लोट`    | हाँ      | SPOT ऑफ़र के लिए न्यूनतम कीमत प्रति दिन    |

**आउटपुट**

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

**उदाहरण**

आइए वर्तमान वॉलेट से भेजे गए लेनदेन के लिए एक सेंड प्रूफ बनाएं।

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "name": "Jan Vykydal",
    "availability":true,
    "mrl":96,
    "on_demand":0.0001,
    "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             |
| `इच्छित_कीमत` | `फ्लोट` | हाँ      | आपकी प्रतिदिन पेश की गई कीमत |

**उदाहरण**

आइए स्पॉट मार्केट कीमत को अपडेट करने का प्रयास करें

**इनपुट 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` | `फ्लोट`    | सबसे कम संभव मान जिसकी ओर आप वर्तमान में कीमत घटा सकते हैं |

```
{
    "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` | `फ्लोट`    | अगली बार कीमत घटाने की संभाव्यता तक शेष समय (सेकंड) |

```
{
    "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>

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

अपने SPOT मार्केट ऑफ़र पर प्रति दिन कीमत सेट करें

**हेडर**

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

**बॉडी**

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

**आउटपुट**

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

**उदाहरण**

ऑर्डर/ऑफ़र रद्द करें

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

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"GPU #1 अधिक गर्म हो रहा था और थ्रॉटल कर रहा था"
}' 'https://api.clore.ai/v1/cancel_order'
```

**आउटपुट:**

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

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

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

आप इस एंडपॉइंट से स्पॉट ऑफ़र या ऑन-डिमांड ऑर्डर बना सकते हैं\
यह एंडपॉइंट भी केवल 5 सेकंड में 1 अनुरोध की अनुमति देता है

**हेडर**

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

**बॉडी**

| फ़ील्ड               | प्रकार     | अनिवार्य       | विवरण                                                                                                                                             |
| -------------------- | ---------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `मुद्रा`             | `स्ट्रिंग` | हाँ            | मुद्रा का नाम                                                                                                                                     |
| `image`              | `स्ट्रिंग` | हाँ            | dockerhub से मान्य इमेज                                                                                                                           |
| `renting_server`     | `int`      | हाँ            | उस सर्वर की ID जिसे आप किराए पर लेना चाहते हैं                                                                                                    |
| `प्रकार`             | `स्ट्रिंग` | हाँ            | `on-demand` या `spot`                                                                                                                             |
| `spotprice`          | `फ्लोट`    | निर्भर करता है | स्पॉट मार्केट पर प्रति दिन पेश की गई कीमत, स्पॉट ऑर्डर बनाते समय आवश्यक                                                                           |
| `ports`              | `ऑब्जेक्ट` | नहीं           | पोर्ट फॉरवर्डिंग कॉन्फ़िगरेशन, अधिकतम 5 रिकॉर्ड                                                                                                   |
| `env`                | `ऑब्जेक्ट` | नहीं           | <p>पर्यावरण चर, स्ट्रिंग में बदलने पर कुल मिलाकर 12000 अक्षरों तक सीमित।<br>वैरिएबल नाम - अधिकतम 128 अक्षर<br>वैरिएबल मान - अधिकतम 1536 अक्षर</p> |
| `jupyter_token`      | `स्ट्रिंग` | नहीं           | जुपिटर टोकन उन इमेज के लिए जिनमें जुपिटर नोटबुक हैं, अधिकतम 32 अक्षर \*                                                                           |
| `ssh_key`            | `स्ट्रिंग` | नहीं           | SSH की उन इमेज के लिए जिनमें SSH है, अधिकतम 3072 अक्षर \*                                                                                         |
| `ssh_password`       | `स्ट्रिंग` | नहीं           | SSH पासवर्ड उन इमेज के लिए जिनमें SSH है, अधिकतम 32 अक्षर \*                                                                                      |
| `command`            | `स्ट्रिंग` | नहीं           | ऑर्डर बनाने के बाद सर्वर पर कमांड चलाया जाएगा                                                                                                     |
| `required_price`     | `फ्लोट`    | नहीं           | उस कीमत का निर्दिष्ट करें जिस पर आप ऑर्डर शुरू करना चाहते हैं, यदि मशीन मालिक कीमत बदलता है, तो ऑर्डर शुरू नहीं होगा (सिर्फ ऑन-डिमांड)            |
| `autossh_entrypoint` | `बूल`      | नहीं           | clore.ai एंट्रीपॉइंट का उपयोग करें, जो स्वचालित रूप से SSH सर्वर और कस्टम तैनात करता है `/root/onstart.sh` स्क्रिप्ट                              |

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

**आउटपुट**

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

**उदाहरण**

**इनपुट 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
}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.