_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 令牌 |
| `Content-type` | `字符串` | 是 | 必须是 `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 令牌 |
| `Content-type` | `字符串` | 是 | 必须是 `application/json` |
**请求体**
| 字段 | 类型 | 必填 | 描述 |
| ------- | ----- | -- | ----------------------------------------------------------------- |
| `id` | `整数` | 是 | 唯一的订单/报价 ID |
| `issue` | `字符串` | 否 | 如果你遇到服务器的任何问题，可以将其报告给 [clore.ai](http://clore.ai/) 团队，最多 2048 个字符 |
**输出**
| 字段 | 类型 | 描述 |
| ------ | ---- | --- |
| `code` | `整数` | 状态码 |
**示例**
取消订单/报价
**输入：**\
在此示例中，我们正在报告 GPU #1 的问题；如果你没有问题，请不要包含 issue 字段。\n你可以在文本字段中写任何消息，我们会进行调查
```
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` | `字符串` | 是 | API 令牌 |
| `Content-type` | `字符串` | 是 | 必须是 `application/json` |
**请求体**
| 字段 | 类型 | 必填 | 描述 |
| -------------------- | ------- | --- | -------------------------------------------------------------------------------------------------------------------------- |
| `currency` | `字符串` | 是 | 货币名称 |
| `image` | `字符串` | 是 | 来自 Docker Hub 的有效镜像 |
| `renting_server` | `整数` | 是 | 你想租用的服务器 ID |
| `类型` | `字符串` | 是 | `on-demand` 或 `spot` |
| `spotprice` | `浮点数` | 取决于 | 在现货市场上的每日报价价格，创建现货订单时必填 |
| `端口` | `对象` | 否 | 端口转发配置，最多 5 条记录 |
| `env` | `对象` | 否 | 环境变量，字符串化后总长度限制为 12288 个字符。\n变量名 - 最多 128 个字符，不能包含 -
变量值 - 最多 1536 个字符\n仅保留前 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-eng-zh/mian-xiang-zu-yong-zhe/partial-gpu-rental.md)。省略则租用整机。仅限按需，仅限同构整机 |
| `gpu_indices` | `[]int` | 否 | 要租用的 GPU 插槽索引（从 0 开始）；长度必须等于 `gpu_count`。从以下位置获取空闲插槽 `partial_gpu_rental.free_indices`。省略则让后端自动选择空闲 GPU |
| `autossh_entrypoint` | `布尔值` | 否 | 使用 clore.ai 入口点，它会自动部署 SSH 服务器和自定义 `/root/onstart.sh` 脚本 |
\* 对于标有星号的字段，你只能输入此正则表达式组中的字符 `/^[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` | `对象` | 按货币划分的按需订单基础费用（%） |
| `renter_fees.spot` | `对象` | 按货币划分的现货订单基础费用（%） |
| `poh_config.max_reduction_percent` | `整数` | 通过 PoH 可获得的最高基础费用减免（%） |
| `poh_config.max_poh_amount` | `整数` | 达到最高减免时所需的 PoH 余额 |
| `creation_fees.on_demand` | `对象` | 按货币划分的订单创建费用 |
| `creation_fees.spot` | `对象` | 按货币划分的现货订单创建费用 |
| `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 令牌 |
| `Content-type` | `字符串` | 是 | 必须是 `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`
**关于**
获取你的持有证明余额：项目、总额以及 PoH 市场报价金额
**请求头**
| 字段 | 类型 | 必填 | 描述 |
| ------ | ----- | -- | ------ |
| `auth` | `字符串` | 是 | API 令牌 |
**输出**
| 字段 | 类型 | 描述 |
| --------------------------------------------- | ------ | --------------- |
| `code` | `整数` | 状态码 |
| `项目` | `对象数组` | 你的 PoH 项目及其各自余额 |
| `balance.total` | `浮点数` | 所有项目的 PoH 总余额 |
| `balance.free_amount` | `浮点数` | 未投入报价的 PoH 余额 |
| `balance.reward_amount` | `浮点数` | 可获得奖励的余额 |
| `balance.offers.rented_amount` | `浮点数` | 出租给其他用户的数量 |
| `balance.offers.rented_on_marketplace_amount` | `浮点数` | 在 PoH 市场上挂出的数量 |
| `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` | `整数` | 状态码 |
| `国家` | `字符串` | 检测到的国家代码 |
| `节点` | `对象` | 可用的中继节点 |
**输入：**
```
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-eng-zh/mian-xiang-zhu-ji/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.
