astraflow-api
Installation
SKILL.md
星图平台管理API调用指南
星图(AstraFlow)是UCloud面向企业的专属AI开发平台,其下的模型服务子平台叫 UModelVerse。本技能只覆盖管理类API(管理API Key、账单订单、模型广场查询、推理日志查询等),也就是文档里位于 https://astraflow.ucloud.cn/reference/modelverse/ 下的那一批接口。
先弄清楚:管理API ≠ 模型调用API
星图平台实际上有两套完全不同的接口体系,不要混淆:
- 模型调用API(OpenAI/Gemini兼容接口,例如
POST https://api.modelverse.cn/v1/chat/completions):用来真正调用大模型做推理。鉴权方式很简单,只需要一个API Key放进请求头Authorization: Bearer {api_key}即可,不涉及签名计算。这个API Key可以在控制台https://console.ucloud.cn/modelverse/experience/api-keys创建。 - 管理API(本技能覆盖的对象,例如
CreateUMInferAPIKey、ListUMInferRequestLogs):用来管理账号下的资源,比如创建/删除上面那种推理用的API Key、查订单账单、查模型广场数据、查推理日志等。这套接口走的是UCloud通用API体系的PublicKey/PrivateKey签名认证,和UCloud云主机、云硬盘等传统产品线的API是同一套认证机制,跟"模型调用API"的Bearer Token认证完全不是一回事。
后面所有内容都是针对第2种(管理API)。
调用前必须拿到的4个参数
调用任何一个星图管理API,下面4个参数都是必填的: