_spot` переданное значение игнорируется. `usd_pricing` Целевые значения — это показатели $/день для всего сервера, проверяемые по диапазону USD (0.1–1 000); значения вне диапазона ограничиваются ближайшей границей.
**Вывод**
| Поле | Тип | Описание |
| ------ | ----- | ----------- |
| `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`
**О разделе**
Установите цену за день для вашего спотового предложения на рынке
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| -------------- | -------- | ----------- | ------------------------------ |
| `auth` | `string` | Да | API-токен |
| `Content-type` | `string` | Да | Должен быть `application/json` |
**Тело запроса**
| Поле | Тип | Обязательно | Описание |
| --------------- | ------- | ----------- | ------------------------------ |
| `order_id` | `int` | Да | Уникальный ID предложения |
| `desired_price` | `float` | Да | Предложенная вами цена за день |
> **Цена ниже текущего минимального спотового порога сервера** отклоняется с указанием текущего минимума:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "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` | `string` | Поле описания ошибки |
| `максимальный шаг` | `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` | `string` | Поле описания ошибки |
| `time_to_lowering` | `float` | Оставшееся время (сек) до следующей возможности снизить цену |
```
{
"error":"can_lower_every_600_seconds",
"time_to_lowering":513,
"code":6
}
```
#### 9. `cancel_order`
**О разделе**
Отменить активный заказ или спотовое предложение
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| -------------- | -------- | ----------- | ------------------------------ |
| `auth` | `string` | Да | API-токен |
| `Content-type` | `string` | Да | Должен быть `application/json` |
**Тело запроса**
| Поле | Тип | Обязательно | Описание |
| ------- | -------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `int` | Да | Уникальный ID заказа/предложения |
| `issue` | `string` | No | Если вы столкнулись с какими-либо проблемами на сервере, вы можете сообщить о них [маркетплейс](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`
**О разделе**
С помощью этого эндпоинта можно создать спотовое предложение или заказ по требованию
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| -------------- | -------- | ----------- | ------------------------------ |
| `auth` | `string` | Да | API-токен |
| `Content-type` | `string` | Да | Должен быть `application/json` |
**Тело запроса**
| Поле | Тип | Обязательно | Описание |
| -------------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `string` | Да | Название валюты |
| `image` | `string` | Да | Допустимый образ из Docker Hub |
| `renting_server` | `int` | Да | ID сервера, который вы хотите арендовать |
| `тип` | `string` | Да | `по требованию` ИЛИ `спот` |
| `spotprice` | `float` | Зависит | Предлагаемая цена за день на спотовом рынке, обязательна при создании спотового заказа |
| `порты` | `object` | No | Конфигурация проброса портов, максимум 5 записей |
| `env` | `object` | No | Переменные окружения, всего до 12288 символов при сериализации.
Имя переменной — максимум 128 символов, не должно содержать -
Значение переменной — максимум 1536 символов
Сохраняются только первые 30 допустимых переменных; остальные молча отбрасываются
|
| `jupyter_token` | `string` | No | Токен Jupyter для образов, в которых есть блокноты Jupyter, максимум 32 символа \* |
| `ssh_key` | `string` | No | SSH-ключ для образов с SSH, максимум 3072 символа \* |
| `ssh_password` | `string` | No | Пароль SSH для образов с SSH, максимум 32 символа \* |
| `command` | `string` | No | Команда будет выполнена на сервере после создания заказа |
| `required_price` | `float` | No | Укажите цену, по которой вы хотите запустить заказ; если владелец машины изменит цену, заказ не запустится (только для заказов по требованию) |
| `gpu_count` | `int` | No | Количество GPU для аренды на серверах, которые поддерживают [частичную аренду](/clore.ai/clore.ai-ru/dlya-arendatorov/partial-gpu-rental.md). Не указывайте, чтобы арендовать всю ферму. Только по требованию, только однородные фермы |
| `gpu_indices` | `[]int` | No | Индексы слотов GPU, начиная с 0, для аренды; длина должна быть равна `gpu_count`. Возьмите свободные слоты из `partial_gpu_rental.free_indices`. Не указывайте, чтобы бэкенд автоматически выбрал свободные GPU |
| `autossh_entrypoint` | `bool` | No | Использовать точку входа clore.ai, которая автоматически разворачивает SSH-сервер и пользовательский `/root/onstart.sh` скрипт |
\* В поля, отмеченные звездочкой, можно вводить только символы из этой группы регулярного выражения `/^[a-zA-Z0-9\s-=.@+/]+$/`
**Вывод**
| Поле | Тип | Описание |
| ------ | ----- | ----------- |
| `code` | `int` | Код статуса |
> **Спотовые ставки ниже минимального порога сервера** отклоняются с указанием текущего минимума, так что вы можете повторить попытку немедленно:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> Порог пересчитывается по текущим курсам монет примерно каждые 10 минут, поэтому цена, считанная из списка маркетплейса, может быть немного устаревшей — всегда используйте возвращённый `min_price` для повторной попытки.
**Пример**
**Ввод 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
}
```
#### 11. `renter_fees`
**О разделе**
Получите текущую конфигурацию комиссий: базовые комиссии арендатора, настройки уменьшения комиссии PoH, комиссии за создание заказов и ваш баланс PoH
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| ------ | -------- | ----------- | --------- |
| `auth` | `string` | Да | API-токен |
**Вывод**
| Поле | Тип | Описание |
| ---------------------------------- | -------- | -------------------------------------------------------------- |
| `code` | `int` | Код статуса |
| `renter_fees.on_demand` | `object` | Базовая комиссия (%) для заказов по требованию в каждой валюте |
| `renter_fees.spot` | `object` | Базовая комиссия (%) для спотовых заказов в каждой валюте |
| `poh_config.max_reduction_percent` | `int` | Максимальное снижение базовой комиссии через PoH (%) |
| `poh_config.max_poh_amount` | `int` | Баланс PoH, при котором достигается максимальное снижение |
| `creation_fees.on_demand` | `object` | Комиссия за создание заказа для каждой валюты |
| `creation_fees.spot` | `object` | Комиссия за создание спотового заказа для каждой валюты |
| `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`
**О разделе**
Отменить несколько заказов сразу (до 256 за запрос)
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| -------------- | -------- | ----------- | ------------------------------ |
| `auth` | `string` | Да | API-токен |
| `Content-type` | `string` | Да | Должен быть `application/json` |
**Тело запроса**
| Поле | Тип | Обязательно | Описание |
| ----------- | ------- | ----------- | ----------------------------------- |
| `order_ids` | `[]int` | Да | ID заказов для отмены, максимум 256 |
**Вывод**
| Поле | Тип | Описание |
| ------------------ | ------- | --------------------------------------- |
| `code` | `int` | Код статуса |
| `failed_to_cancel` | `[]int` | ID заказов, которые не удалось отменить |
**Вход:**
```
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`
**О разделе**
Получите ваш баланс Proof of Holding: элементы, итоги и суммы предложений PoH Marketplace
**Заголовки**
| Поле | Тип | Обязательно | Описание |
| ------ | -------- | ----------- | --------- |
| `auth` | `string` | Да | API-токен |
**Вывод**
| Поле | Тип | Описание |
| --------------------------------------------- | ---------- | --------------------------------------------- |
| `code` | `int` | Код статуса |
| `элементы` | `[]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 |
| `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`
**О разделе**
Получить статические данные конфигурации API. Аутентификация не требуется
**Вход:**
```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```
#### 15. `get_relay`
**О разделе**
Получить узлы ретрансляции TCP для обнаруженной вами страны. Аутентификация не требуется
**Вывод**
| Поле | Тип | Описание |
| --------- | -------- | --------------------------- |
| `code` | `int` | Код статуса |
| `country` | `string` | Код обнаруженной страны |
| `nodes` | `object` | Доступные узлы ретрансляции |
**Вход:**
```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```
---
# 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-ru/dlya-khostov/api.md?ask=&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.
