_spot` переданное для неё значение игнорируется. `usd_pricing` Целевые значения — это показатели $/день для всего сервера, проверяемые по диапазону USD (0.1–1,000); значения вне диапазона ограничиваются ближайшей границей.
**Вывод**
| Поле | Тип | Описание |
| ------ | ------------- | ----------- |
| `code` | `целое число` | Код статуса |
**Пример**
Давайте создадим подтверждение отправки для транзакции, отправленной из текущего кошелька.
**Вход:**
```
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` | `строка` | Да | API-токен |
| `Тип содержимого` | `строка` | Да | Должен быть `application/json` |
**Тело**
| Поле | Тип | Обязательное | Описание |
| --------------- | -------------------------- | ------------ | ------------------------------ |
| `order_id` | `целое число` | Да | Уникальный ID предложения |
| `desired_price` | `число с плавающей точкой` | Да | Предложенная вами цена за день |
> **Цена ниже текущего спотового минимума сервера** отклоняется с указанием текущего минимума:
>
> ```
> { "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` | `целое число` | Код статуса |
| `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` | `целое число` | Код статуса |
| `error` | `строка` | Поле описания ошибки |
| `time_to_lowering` | `число с плавающей точкой` | Оставшееся время (сек.) до следующей возможности снизить цену |
```
{
"error":"can_lower_every_600_seconds",
"time_to_lowering":513,
"code":6
}
```
#### 9. `cancel_order`
**О разделе**
Отменить активный заказ или спотовое предложение
**Заголовки**
| Поле | Тип | Обязательное | Описание |
| ----------------- | -------- | ------------ | ------------------------------ |
| `auth` | `строка` | Да | API-токен |
| `Тип содержимого` | `строка` | Да | Должен быть `application/json` |
**Тело**
| Поле | Тип | Обязательное | Описание |
| ---------- | ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | `целое число` | Да | Уникальный ID заказа/предложения |
| `проблема` | `строка` | Нет | Если у вас возникли какие-либо проблемы с сервером, вы можете сообщить о них [clore.ai](http://clore.ai/) команде, максимум 2048 символов |
**Вывод**
| Поле | Тип | Описание |
| ------ | ------------- | ----------- |
| `code` | `целое число` | Код статуса |
**Пример**
Отменить заказ/предложение
**Вход:**\
В этом примере мы сообщаем о проблемах с GPU #1; если у вас нет проблем, не включайте поле issue.\
Вы можете написать любое сообщение в текстовое поле, и мы его изучим
```
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`
**О разделе**
С помощью этого endpoint вы можете создать спотовое предложение или заказ по запросу
**Заголовки**
| Поле | Тип | Обязательное | Описание |
| ----------------- | -------- | ------------ | ------------------------------ |
| `auth` | `строка` | Да | API-токен |
| `Тип содержимого` | `строка` | Да | Должен быть `application/json` |
**Тело**
| Поле | Тип | Обязательное | Описание |
| -------------------- | -------------------------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `строка` | Да | Название валюты |
| `image` | `строка` | Да | Допустимый образ из Docker Hub |
| `renting_server` | `целое число` | Да | ID сервера, который вы хотите арендовать |
| `тип` | `строка` | Да | `по запросу` ИЛИ `спот` |
| `spotprice` | `число с плавающей точкой` | Зависит | Предлагаемая цена за день на спотовом рынке, требуется при создании спотового заказа |
| `порты` | `object` | Нет | Конфигурация проброса портов, максимум 5 записей |
| `env` | `object` | Нет | Переменные окружения, всего не более 12288 символов при сериализации.
Имя переменной — максимум 128 символов, не должно содержать -
Значение переменной — максимум 1536 символов
Сохраняются только первые 30 действительных переменных; остальные тихо отбрасываются
|
| `jupyter_token` | `строка` | Нет | Токен Jupyter для образов, в которых есть ноутбуки Jupyter, максимум 32 символа \* |
| `ssh_key` | `строка` | Нет | SSH-ключ для образов с SSH, максимум 3072 символа \* |
| `ssh_password` | `строка` | Нет | Пароль SSH для образов с SSH, максимум 32 символа \* |
| `command` | `строка` | Нет | Команда будет выполнена на сервере после создания заказа |
| `required_price` | `число с плавающей точкой` | Нет | Укажите цену, по которой вы хотите запустить заказ; если владелец машины изменит цену, заказ не запустится (только по запросу) |
| `gpu_count` | `целое число` | Нет | Количество GPU для аренды на серверах, поддерживающих [частичную аренду](/clore.ai/clore.ai-ru/dlya-arendatorov/partial-gpu-rental.md). Укажите, чтобы арендовать всю систему. Только по запросу, только однородные системы |
| `gpu_indices` | `[]int` | Нет | Индексы слотов GPU, арендуемых с нуля; длина должна равняться `gpu_count`. Возьмите свободные слоты из `partial_gpu_rental.free_indices`. Укажите, чтобы бэкенд автоматически выбрал свободные GPU |
| `autossh_entrypoint` | `логическое значение` | Нет | Используйте entrypoint clore.ai, который автоматически разворачивает SSH-сервер и пользовательский `/root/onstart.sh` скрипт |
\* В поля, помеченные звёздочкой, можно вводить только символы из этой группы regexp `/^[a-zA-Z0-9\s-=.@+/]+$/`
**Вывод**
| Поле | Тип | Описание |
| ------ | ------------- | ----------- |
| `code` | `целое число` | Код статуса |
> **Ставки спот ниже минимума сервера** отклоняются с указанием текущего минимума, так что вы можете сразу повторить попытку:
>
> ```
> { "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` | `строка` | Да | API-токен |
**Вывод**
| Поле | Тип | Описание |
| ---------------------------------- | -------------------------- | ------------------------------------------------------------ |
| `code` | `целое число` | Код статуса |
| `renter_fees.on_demand` | `object` | Базовая комиссия (%) по каждой валюте для заказов по запросу |
| `renter_fees.spot` | `object` | Базовая комиссия (%) по каждой валюте для спотовых заказов |
| `poh_config.max_reduction_percent` | `целое число` | Максимальное снижение базовой комиссии через PoH (%) |
| `poh_config.max_poh_amount` | `целое число` | Баланс PoH, при котором достигается максимальное снижение |
| `creation_fees.on_demand` | `object` | Комиссия за создание заказа по каждой валюте |
| `creation_fees.spot` | `object` | Комиссия за создание спотового заказа по каждой валюте |
| `poh_balance` | `число с плавающей точкой` | Ваш баланс 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` | `строка` | Да | API-токен |
| `Тип содержимого` | `строка` | Да | Должен быть `application/json` |
**Тело**
| Поле | Тип | Обязательное | Описание |
| ----------- | ------- | ------------ | ----------------------------------- |
| `order_ids` | `[]int` | Да | ID заказов для отмены, максимум 256 |
**Вывод**
| Поле | Тип | Описание |
| ------------------ | ------------- | --------------------------------------- |
| `code` | `целое число` | Код статуса |
| `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` | `строка` | Да | API-токен |
**Вывод**
| Поле | Тип | Описание |
| --------------------------------------------- | -------------------------- | ------------------------------------------------- |
| `code` | `целое число` | Код статуса |
| `элементы` | `[]object` | Ваши элементы PoH с отдельными балансами |
| `balance.total` | `число с плавающей точкой` | Общий баланс PoH по всем элементам |
| `balance.free_amount` | `число с плавающей точкой` | Баланс PoH, не закреплённый за предложениями |
| `balance.reward_amount` | `число с плавающей точкой` | Баланс, имеющий право на вознаграждения |
| `balance.offers.rented_amount` | `число с плавающей точкой` | Количество, сданное в аренду другим пользователям |
| `balance.offers.rented_on_marketplace_amount` | `число с плавающей точкой` | Количество, размещённое на PoH Marketplace |
| `balance.offers.leased_amount` | `число с плавающей точкой` | Количество, арендованное у других пользователей |
**Вход:**
```
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` | `целое число` | Код статуса |
| `страна` | `строка` | Код обнаруженной страны |
| `узлы` | `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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.