列出计算规格

列出当前工作区可见的计算规格。

GET https://moi.matrixorigin.cn/newmoi/compute-resource-specs

调用前准备

准备有目标工作区访问权限的个人访问令牌和目标工作区 ID。

下方示例使用：

• $AI_STUDIO_API_KEY：实际个人访问令牌，通过 X-API-Key Header 传递。

• $WORKSPACE_ID：要查询的工作区 ID，通过 X-Workspace-ID Header 传递。

创建实例前重新读取本接口，不要假设其他工作区的规格可用。

请求示例

curl "https://moi.matrixorigin.cn/newmoi/compute-resource-specs" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

成功响应

成功时返回 200，data 为计算规格数组。

{
  "code": "OK",
  "msg": "OK",
  "data": [
    {
      "id": "task-standard-small",
      "kind": "task",
      "family": "standard",
      "cpu_milli": 2000,
      "memory_mib": 4096,
      "gpu_count": 0,
      "credit_per_hour": 1,
      "enabled": true
    }
  ]
}

响应字段如下。

字段路径中的 [] 表示数组中的每一项。例如，data[].id 表示 data 数组中每一项的 id 字段。

字段	类型	说明
code	string	成功时为 OK。
msg	string	成功时为 OK。
data[].id	string	规格 ID，用于创建计算实例。
data[].kind	string	资源类型。
data[].family	string	规格族标识。
data[].family_name	string	规格族名称。
data[].family_name_en	string	规格族英文名称。
data[].cpu_milli	integer	CPU 容量，单位为毫核。
data[].memory_mib	integer	内存容量，单位为 MiB。
data[].gpu_count	integer	GPU 数量。
data[].gpu_memory_mib	integer	GPU 显存，单位为 MiB。
data[].gpu_cores	integer	GPU 核数。
data[].credit_per_hour	number	每小时 Credit 用量。
data[].description	string	规格说明。
data[].description_en	string	英文规格说明。
data[].node_placement	object	节点调度配置。
data[].enabled	boolean	规格是否启用。
data[].is_system	boolean	是否为系统内置规格。
data[].created_by	string	创建者标识。
data[].updated_by	string	最后更新者标识。
data[].created_at	string	创建时间。
data[].updated_at	string	最后更新时间。

错误响应

{
  "code": "LIST_SPECS_FAILED",
  "msg": "failed to list compute resource specs",
  "data": null
}

常见 HTTP 错误

HTTP 状态码	错误代码	常见原因	建议操作
401	—	缺少、无效或已失效的访问凭据。	检查 API Key。
403	—	当前身份无权访问该工作区的规格。	检查工作区 ID 与访问权限。
500	LIST_SPECS_FAILED	服务端无法读取规格列表。	稍后重试；持续失败时联系支持人员。

后续操作

使用已启用规格的 id 创建计算实例。

最后更新于 2026 年 8 月 22 日