共绩科技
  1. 任务
共绩科技
  • 共绩算力 Open API
    • 任务
      • 显卡资源查询接口
        GET
      • 任务创建接口
        POST
      • 任务列表查询接口
        GET
      • 任务详情查询接口
        GET
      • 任务暂停接口
        POST
      • 任务删除接口
        POST
      • 任务恢复接口
        POST
      • 任务修改接口
        POST
      • 任务自定义YAML校验接口
        POST
    • 节点
      • 任务节点列表查询接口
      • 任务节点数量修改接口
      • 任务节点删除接口
      • 任务节点关机接口
      • 获取任务节点日志
      • 获取任务Pod事件
    • 计费管理
      • 获取计费记录
    • 存储
      • 存储配置列表
  1. 任务

显卡资源查询接口

GET
/api/deployment/resource/search
此接口为资源查询接口,作为任务发布的前置流程。尤其需要注意mark标识,此为后续发布任务时标注卡类型所必须。对于同一种资源(如4090),不同数量的卡对应不同的mark,建议您获取先获取最新的mark标识在进行其他接口的操作。
API 加验签说明
根据 API 密钥模式,支持两种调用方式:
快速模式:仅需在 Header 中传递 token 参数
RSA 模式:需要 RSA 签名验证,需额外传递 token、timestamp、version、sign_str 参数。
签名生成步骤
1.
构建待签名字符串:
path: 接口地址(如:/api/deployment/task/create)
version: 请求头中的接口版本(如:1.0.0)
timestamp: 请求头中的时间戳(毫秒)
token: 请求头中的 token
data: 接口请求体 JSON 字符串
2.
使用 RSA-SHA256 算法对待签名字符串进行签名
3.
将签名结果转换为 Base64 字符串
4.
将 Base64 签名字符串设置到请求头的 sign_str 字段。
注意事项: - 签名字符串中各参数用换行符 \n 连接 - 如果请求体需要加密,则 data 为加密后的 Base64 字符串 - 同时需要加密和加签时,必须先进行加密步骤,再进行加签步骤

请求参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://openapi.suanli.cn/api/deployment/resource/search' \
--header 'token;' \
--header 'version: 1.0.0' \
--header 'timestamp: 1747379023000'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "0000",
    "message": "success",
    "data": {
        "count": 5,
        "results": [
            {
                "device_name": "910B x 4",
                "region_map": {
                    "qinghai-yidong": {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 4",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 4,
                                "gpu_memory": 98256,
                                "memory": 258048,
                                "cpu_cores": 52
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyMyihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjups8icZRTMuMv4NsRTnf22cxSBoH2+w5O/tMVt6rnGUV4FNnCeQyf5tnXGrF3h1QdDoW5ENkfTk3pozSvQcjMJ2D+OZhs"
                        },
                        "price": 0,
                        "inventory": 1
                    }
                },
                "regions": [
                    {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 4",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 4,
                                "gpu_memory": 98256,
                                "memory": 258048,
                                "cpu_cores": 52
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyMyihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjups8icZRTMuMv4NsRTnf22cxSBoH2+w5O/tMVt6rnGUV4FNnCeQyf5tnXGrF3h1QdDoW5ENkfTk3pozSvQcjMJ2D+OZhs"
                        },
                        "price": 0,
                        "inventory": 1
                    }
                ],
                "gpu_name": "910B",
                "gpu_memory": 98256,
                "gpu_count": 4,
                "memory": 258048,
                "cpu_cores": 52
            },
            {
                "device_name": "910B x 2",
                "region_map": {
                    "qinghai-yidong": {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 2",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 2,
                                "gpu_memory": 49128,
                                "memory": 129024,
                                "cpu_cores": 26
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyM0ihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjupskicZRTMuMv4NsRTnf22cFTBYb4+w5O/tMVt6rnGUZ/FdnEdQyf5tnXGrF3h1QdDoW+FNlcLANYXyJMWyAQntY8Xe+k"
                        },
                        "price": 0,
                        "inventory": 3
                    }
                },
                "regions": [
                    {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 2",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 2,
                                "gpu_memory": 49128,
                                "memory": 129024,
                                "cpu_cores": 26
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyM0ihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjupskicZRTMuMv4NsRTnf22cFTBYb4+w5O/tMVt6rnGUZ/FdnEdQyf5tnXGrF3h1QdDoW+FNlcLANYXyJMWyAQntY8Xe+k"
                        },
                        "price": 0,
                        "inventory": 3
                    }
                ],
                "gpu_name": "910B",
                "gpu_memory": 49128,
                "gpu_count": 2,
                "memory": 129024,
                "cpu_cores": 26
            },
            {
                "device_name": "910B x 2",
                "region_map": {
                    "jinshan-xining": {
                        "region": "jinshan-xining",
                        "region_name": "河北-廊坊",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 2",
                                "region": "jinshan-xining",
                                "gpu_name": "910B",
                                "gpu_count": 2,
                                "gpu_memory": 49128,
                                "memory": 131072,
                                "cpu_cores": 32
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyM0ihjJQqeFKqK17sDwaqU01ePHMf9tSQtneyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjupskicZRTMuMv4NsRTnf22cFTBYb4+w5O/tMVt6rnGUZ+HdnBcwyf5tnXGrF3h1QdDoW/ENkxUD5hTnx0BTljh2OArSDR"
                        },
                        "price": 0,
                        "inventory": 1
                    }
                },
                "regions": [
                    {
                        "region": "jinshan-xining",
                        "region_name": "河北-廊坊",
                        "mark": {
                            "resource": {
                                "device_name": "910B x 2",
                                "region": "jinshan-xining",
                                "gpu_name": "910B",
                                "gpu_count": 2,
                                "gpu_memory": 49128,
                                "memory": 131072,
                                "cpu_cores": 32
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyM0ihjJQqeFKqK17sDwaqU01ePHMf9tSQtneyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjupskicZRTMuMv4NsRTnf22cFTBYb4+w5O/tMVt6rnGUZ+HdnBcwyf5tnXGrF3h1QdDoW/ENkxUD5hTnx0BTljh2OArSDR"
                        },
                        "price": 0,
                        "inventory": 1
                    }
                ],
                "gpu_name": "910B",
                "gpu_memory": 49128,
                "gpu_count": 2,
                "memory": 131072,
                "cpu_cores": 32
            },
            {
                "device_name": "910B",
                "region_map": {
                    "qinghai-yidong": {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 1,
                                "gpu_memory": 24564,
                                "memory": 64512,
                                "cpu_cores": 13
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS9cyF0zVOCX6zAee+qpZS1aK0zi/LPO717R0ciNymOGDHuJ2PCZ0+HVA92mq25CHio0t/pzLOdQa0paiDu+4t7DJ5GKtMw/JREDjrh1cFGFtmlukNR4pxA8+fwEkVhDoqGNH/e6tvHNvAixAITrMHYswpXMjhablYihexEyw=="
                        },
                        "price": 0,
                        "inventory": 6
                    }
                },
                "regions": [
                    {
                        "region": "qinghai-yidong",
                        "region_name": "青海-移动",
                        "mark": {
                            "resource": {
                                "device_name": "910B",
                                "region": "qinghai-yidong",
                                "gpu_name": "910B",
                                "gpu_count": 1,
                                "gpu_memory": 24564,
                                "memory": 64512,
                                "cpu_cores": 13
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS9cyF0zVOCX6zAee+qpZS1aK0zi/LPO717R0ciNymOGDHuJ2PCZ0+HVA92mq25CHio0t/pzLOdQa0paiDu+4t7DJ5GKtMw/JREDjrh1cFGFtmlukNR4pxA8+fwEkVhDoqGNH/e6tvHNvAixAITrMHYswpXMjhablYihexEyw=="
                        },
                        "price": 0,
                        "inventory": 6
                    }
                ],
                "gpu_name": "910B",
                "gpu_memory": 24564,
                "gpu_count": 1,
                "memory": 64512,
                "cpu_cores": 13
            },
            {
                "device_name": "910B",
                "region_map": {
                    "jinshan-xining": {
                        "region": "jinshan-xining",
                        "region_name": "河北-廊坊",
                        "mark": {
                            "resource": {
                                "device_name": "910B",
                                "region": "jinshan-xining",
                                "gpu_name": "910B",
                                "gpu_count": 1,
                                "gpu_memory": 24564,
                                "memory": 65536,
                                "cpu_cores": 16
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS9cyF0zVOCX6zAee+xpZShaK00i/PPMbt7R0ciNymOGDHuJ2PCZ0+HVA92mq25CHio0t/pzLOdQa0paiDu+4t7DJ5GKtMw/JREDjrh1cFGFtmlukNR4pxA8+bwEEFhDoqGNH/e6tvHNvAixAcT3Peu79udTGIz/kFFV1vh0A=="
                        },
                        "price": 0,
                        "inventory": 4
                    }
                },
                "regions": [
                    {
                        "region": "jinshan-xining",
                        "region_name": "河北-廊坊",
                        "mark": {
                            "resource": {
                                "device_name": "910B",
                                "region": "jinshan-xining",
                                "gpu_name": "910B",
                                "gpu_count": 1,
                                "gpu_memory": 24564,
                                "memory": 65536,
                                "cpu_cores": 16
                            },
                            "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS9cyF0zVOCX6zAee+xpZShaK00i/PPMbt7R0ciNymOGDHuJ2PCZ0+HVA92mq25CHio0t/pzLOdQa0paiDu+4t7DJ5GKtMw/JREDjrh1cFGFtmlukNR4pxA8+bwEEFhDoqGNH/e6tvHNvAixAcT3Peu79udTGIz/kFFV1vh0A=="
                        },
                        "price": 0,
                        "inventory": 4
                    }
                ],
                "gpu_name": "910B",
                "gpu_memory": 24564,
                "gpu_count": 1,
                "memory": 65536,
                "cpu_cores": 16
            }
        ]
    }
}
修改于 2025-08-11 06:34:42
下一页
任务创建接口
Built with