可用工具
KPainter MCP 提供八個工具，覆蓋發現、上傳、創建、查詢、修改、繼續和輸出。
| 工具 | 什麼時候使用 |
|---|---|
| KP - 能力 | 創建前讀取產品、文件、視頻模板、音色和圖片模型 |
| 此分類上一篇: Upload_file | 上傳一個 base64 編碼的輸入文件並取得 file_id |
| KP 創建 | 創建 video、image 或 app |
| KP / 列表 | 分頁查看當前賬號的創建記錄 |
| KP / GET | 查詢單個 creation 的狀態、進度、ETA、積分和可用操作 |
| KP - 消息 | 用自然語言繼續修改解說視頻 |
| KP / ACT | 執行 kp_get 明確返回的暫停恢復操作 |
| KP / 出口 | 獲取已經可交付的結果 URL |
創建順序
- KP - 能力
- 需要附件時調用 kp_upload_file
- KP 創建
- kp_get，直到終態
- KP / 出口
修改視頻
- 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、積分或輸出地址。