可用工具
KPainter MCP 提供八个工具，覆盖发现、上传、创建、查询、修改、继续和输出。
| 工具 | 什么时候使用 |
|---|---|
| kp_capabilities | 创建前读取产品、文件、视频模板、音色和图片模型 |
| kp_upload_file | 上传一个 base64 编码的输入文件并取得 file_id |
| kp_create | 创建 video、image 或 app |
| kp_list | 分页查看当前账号的创建记录 |
| kp_get | 查询单个 creation 的状态、进度、ETA、积分和可用操作 |
| kp_message | 用自然语言继续修改解说视频 |
| kp_act | 执行 kp_get 明确返回的暂停恢复操作 |
| kp_outputs | 获取已经可交付的结果 URL |
创建顺序
- kp_capabilities
- 需要附件时调用 kp_upload_file
- kp_create
- kp_get，直到终态
- kp_outputs
修改视频
- kp_get 确认当前状态。
- kp_message 提交修改说明和稳定的 idempotency_key。
- 继续 kp_get。
- 完成后重新 kp_outputs。
继续暂停任务
- kp_get 读取 available_actions。
- 用户完成充值或确认后调用 kp_act。
- action 必须来自 available_actions。
- 同一次操作复用同一个 idempotency_key。
- 只继续最新暂停任务。
参数规则
- 所有公开字段使用 snake_case。
- kp_create 的公共字段为 type、prompt、instructions、input_file_ids、max_credits。
- 产品参数放入同名 video、image 或 app 对象。
- 图片 provider 与 model 必须使用 capabilities 中的完整组合。
- 只发送本页和 kp_capabilities 返回的公开字段。
- 不要猜测状态、ETA、积分或输出地址。