MCP 与 Skill

安装资源

下载 Skill 包或读取 SKILL.md。接口机器可读描述见 OpenAPI 与 llms.txt。Skill 下载内容会使用当前服务域名。

工具调用

使用 Streamable HTTP MCP，先由客户端完成 initialize，再查询 tools/list。可使用 OAuth 或控制台创建的 Bearer API Key。

• models.list、models.get：模型与参数
• pricing.quote：人民币报价
• tasks.create：接受报价并创建任务
• tasks.get、tasks.list、tasks.cancel：查询与取消
• wallet.get、billing.list：余额与费用
• assets.upload.prepare、assets.upload.get、assets.upload.complete：本地文件上传与登记
• assets.get、assets.import、assets.delete：资源
• voices.list：个人音色

创建任务

先查询模型实际 available 状态，再获取报价。tasks.create 必须传入 quote_id 和 8 至 150 字符的 idempotency_key；一次创作的重试始终沿用原键。不能根据模型名称猜测价格，也不能在受理状态未知时重复提交。

权限错误

认证失败在 HTTP 层返回 401 和授权发现地址。工具权限不足返回 isError=true，结构化文本中的 error.code 为 SCOPE_REQUIRED。工具业务错误不会包含供应商密钥或内部采购金额。