快速開始
下面以本地 stdio 為例連接 KPainter MCP，並創建第一個結果。
1. 準備 API Key
- 登錄 KPainter。
- 打開 API Key 頁面。
- 激活並複製 Key。
- 將 Key 放入 MCP 客戶端的安全配置。
2. 配置 stdio
如果環境中已安裝 kp-mcp：
{ "mcpServers": { "kpainter": { "command": "kp-mcp", "args": ["--stdio"], "env": { "KGP_API_KEY": "<your_api_key>" } } }}從 kgp-service 源碼運行時：
{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server", "--stdio"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } }}3. 讀取能力
連接成功後，先調用 kp_capabilities。確認：
- 當前賬號可用。
- products 中包含想創建的類型。
- 文件、視頻、圖片或應用參數來自最新響應。
4. 創建第一個結果
調用 kp_create：
{ "type": "video", "prompt": "面向新员工解释客户问题升级流程", "max_credits": 300, "video": { "duration_seconds": 120, "aspect_ratio": "16:9", "language": "zh" }}如果有附件，先使用 kp_upload_file，並把返回的 file_id 放入 input_file_ids。
5. 查詢和獲取結果
- 定期調用 kp_get。
- planning 或 producing 時繼續等待。
- ready 後調用 kp_outputs。
- paused 時讀取 available_actions，不要直接創建重複任務。
- failed 時向用戶展示簡明原因和可以採取的下一步。
6. 繼續修改視頻
{ "creation_id": "creation_xxx", "content": "保留其他部分，把第二个场景讲得更简单", "idempotency_key": "video-edit-20260901-001"}把上面參數傳給 kp_message，然後繼續用 kp_get 查詢同一個 creation。