用途:本技能面向星图平台(AstraFlow)下模型服务子平台 UModelVerse 的管理类API调用,即位于 https://astraflow.ucloud.cn/reference/modelverse 下的一批接口,用于管理推理API Key、查询账单订单、查询模型广场数据、导出或查询推理请求日志等。它不覆盖模型调用API(如 POST https://api.modelverse.cn/v1/chat/completions,用 Bearer Token 鉴权),两者鉴权体系不同。
主要能力:references/ 目录收录已确认存在的21个管理API规范,含推理API Key管理(CreateUMInferAPIKey、DeleteUMInferAPIKey、UpdateUMInferAPIKey、ListUMInferAPIKey)、订单与账单(DownloadListPaidOrders、ListPaidOrders、StartPayUnpaidOrders 等)、模型广场(GetUFSquareModelDetail、ListUFSquareModel、ListUFSquareModelFiltersAuth 等)、推理日志(DownloadUMInferRequestLog、ListUMInferRequestLogs 等)。
使用方式:请求地址为 https://api.ucloud.cn,支持 GET/POST,需公共参数 Action、PublicKey、Signature 及业务参数(如 Region、ProjectId)。Signature 计算:收集除 Signature 外全部参数,按参数名ASCII升序排列,依次拼接参数名与参数值(不做URL转义),末尾追加 PrivateKey,取 SHA1 小写十六进制值。布尔写 true/false,整数部分为0的浮点只写整数,数组按 ModelNames.0 等展开键名参与排序。PrivateKey 仅本地签名,不得回显、写日志或提交仓库。签名可用 sha1sum 于本地计算后作为普通参数发送。
适用场景与限制:适用于代用户发起星图管理API调用前的准备与参数核对。调用前应先确认目标接口的业务参数,不要跨接口照抄。Region 可用 ListUMInferRegions 查询,文档列出的UCloud全平台33个地域不代表星图已开通。ProjectId 可通过 GetProjectList 获取,需向用户确认。常见错误码包括170缺少签名、171签名错误、160/161缺少或不存在Action、292项目不存在、294访问IP被拒绝。官方文档存在若干字段类型与示例不一致之处,如 CreateUMInferAPIKey 的 Data 字段、ListUMInferRequestLogs 多出的 TotalCount、GetOrderAmount 缺少 TotalOrderAmount 等,应以真实返回为准。
现状:上述接口列表可能不完整(如 ListUMInferRegions 未收录),发现新接口可依同模板补充。