MCP 工具参考
从注册 MCP 工具生成参数、返回结构、OAuth 权限、副作用、支出保护与经过核实的开放状态。
本页目录
开放状态与工作流
官方 MCP 已开放公开测试，端点为 https://api.animgen.com/mcp。使用 Streamable HTTP 与 OAuth，需要已验证的 AnimGen 账户；订阅提高限额，建立连接不等于批准消费。
工具列表
| 工具 | 权限 | 用途 |
|---|---|---|
| list_models | models:read |
查询当前启用模型、合法参数、默认值与输入能力，不启动生成。 |
| prepare_image_upload | files:write |
创建短期上传会话；客户端按返回的方法和请求头上传准确字节，再完成上传。本地路径不能替代文件传输。 |
| complete_image_upload | files:write |
校验已传输的图片并返回可复用 file_id；此 ID 用于生成输入。 |
| quote_animation | animations:write |
计算当前费用并创建属于当前用户和 OAuth 客户端的短期 quote_id，不启动生成或扣费。 |
| generate_animation | animations:write |
启动付费异步动画，必须有用户批准的 quote_id 或 max_credits，并保存幂等键。两个支出字段与 request 同级；生成开始后可能扣费。 |
| get_animation | animations:read |
查询状态、进度、积分、错误和已有资产；失败或取消也要检查 outputs。 |
| download_asset | assets:read |
返回所属资产信息和短期签名 URL，不自动保存本地文件；下载不携带 API 或 OAuth 凭据。 |
| cancel_animation | animations:write |
尽力取消所属任务，可能仍需轮询；已扣积分不自动退回，先前产物可能保留。 |
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策