# MCP 与 Skill

## 安装资源

[下载 Skill 包](/skills/jisu.zip)或读取 [SKILL.md](/skill.md)。接口机器可读描述见 [OpenAPI](/openapi.json) 与 [llms.txt](/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。工具业务错误不会包含供应商密钥或内部采购金额。