可用工具
KPainter MCP 当前对齐的是最小 public OpenAPI 能力面。
Tools
| Tool | 用途 |
|---|---|
kp_health |
检查 MCP 适配层是否可达 |
kp_me |
校验当前 API Key，并确认是否具备创作能力 |
kp_get_catalog |
读取当前允许的内容类型、音色、风格和限制 |
kp_create_creation |
发起一次内容创建 |
kp_list_creations |
查看当前用户的创作列表 |
kp_get_creation |
读取单条创作的完整详情、URL、artifacts 和 scenes |
kp_get_job_status |
轮询创建或编辑任务状态 |
kp_edit_creation |
发起分镜编辑或 Omni AI 视频多轮迭代 |
Resources
| Resource | 用途 |
|---|---|
kp://openapi/overview |
查看 public OpenAPI 和 MCP 工作流概览 |
kp://catalog/default |
读取服务端默认 key 对应的 catalog |
kp://creations/{creation_id} |
读取服务端默认 key 对应的创作详情 |
resources 更适合作为辅助读取面。真正的用户级工作流，主入口仍然是 tools。
Prompts
| Prompt | 用途 |
|---|---|
create_creation_workflow |
引导模型完成类型选择和异步创建 |
edit_scene_workflow |
引导模型完成一次单场景编辑 |
推荐调用顺序
新建内容时：
kp_mekp_get_catalogkp_create_creationkp_get_job_statuskp_get_creation
改单场景时：
kp_get_creation- 检查
editable_actions和scenes kp_edit_creationkp_get_job_statuskp_get_creation
几条最重要的注意点
- 先调
kp_get_catalog，再决定内容类型和参数 kp_create_creation使用image_model、video_model等扁平模型参数，不接受 REST OpenAPI 的嵌套请求对象- 创建和编辑都按异步工作流处理
- 只使用正式内容类型：
explainer_video、read_aloud_video、vector_animation、image、ai_video、slides、interactive_lesson - 只有用户明确要求“矢量动画”时才选择
vector_animation kp_edit_creation支持update_scene_narration、regenerate_scene，以及 Omni AI 视频的iterate- MCP 不暴露支付、订阅、API Key 管理，也不替代主站更重的编辑能力