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，不启动生成或扣费。 |
| quote_video_generation | animations:write |
只报价视频生成，不启动导出或生成。 |
| generate_animation | animations:write |
启动付费异步动画，必须有用户批准的 quote_id 或 max_credits，并保存幂等键。两个支出字段与 request 同级；生成开始后可能扣费。 |
| generate_video | animations:write |
创建独立视频任务；需批准的 quote_id 或 max_credits 及幂等键。保存输出视频资产 ID。 |
| get_animation | animations:read |
查询状态、进度、积分、错误和已有资产；失败或取消也要检查 outputs。 |
| get_video_generation | animations:read |
查询独立视频任务、媒体元数据、部分产物和积分状态。 |
| download_asset | assets:read |
返回所属资产信息和短期签名 URL，不自动保存本地文件；下载不携带 API 或 OAuth 凭据。 |
| preview_video | assets:read |
返回最多 12 格带时间标签的联系表与实际源时间；下载图片后查看。不调用 AI 或扣积分，计入存储并受媒体预算限制。 |
| quote_animation_export | animations:write |
为已有视频报价，FPS 模式返回确定的采样摘要，不重新生成源视频。 |
| export_animation | animations:write |
从所属视频资产导出选区；需批准的报价或积分上限与幂等键，修改选区或 FPS 只重新导出。 |
| get_animation_export | animations:read |
查询独立导出任务、采样摘要和产物；失败或取消也检查 outputs。 |
| cancel_animation | animations:write |
尽力取消所属任务，可能仍需轮询；已扣积分不自动退回，先前产物可能保留。 |
| cancel_video_generation | animations:write |
尽力取消视频任务并继续轮询，取消不保证退款。 |
| cancel_animation_export | animations:write |
只取消导出，保留仍有效的源视频；继续轮询到终态。 |
这篇文档有帮助吗？
不收集搜索词、代码或自由文本。此开关只控制文档交互事件；站点通用分析仍遵循隐私政策。 隐私政策