QuickStart khởi động
Ví dụ này kết nối KPainter MCP qua stdio địa phương và tạo ra kết quả đầu tiên.
1.Cung cấp một API Key
- Đăng nhập vào KPainter.
- Mở The API Trang chủ.
- Tạo và sao chép chìa khóa
- Lưu nó trong cấu hình an toàn của MCP client.
2.Cài đặt Stdio
Khi cp-mcp được cài đặt:
{ "mcpServers": { "kpainter": { "command": "kp-mcp", "args": ["--stdio"], "env": { "KGP_API_KEY": "<your_api_key>" } } }}
Từ thư mục nguồn dịch vụ kgp:
{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server", "--stdio"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } }}
3. đọc kỹ năng
Đầu tiên gọi kp_capabilities. xác nhận rằng:
- Tài khoản có sẵn
- Sản phẩm bao gồm kết quả dự định
- file, video, hình ảnh, hoặc ứng dụng cài đặt đến từ câu trả lời này
4. tạo ra kết quả đầu tiên
Nhập KP_Create :
{ "type": "video", "prompt": "Explain the customer escalation process to new employees", "max_credits": 300, "video": { "duration_seconds": 120, "aspect_ratio": "16:9", "language": "en" }}
Đối với các tệp nguồn, gọi kp_upload_file đầu tiên và đặt mỗi file_id được trả về vào input_file_ids.
5.Poll và Read Output
- gọi kp_get thường xuyên.
- Tiếp tục chờ đợi trong quá trình lập kế hoạch hoặc sản xuất.
- Khởi động kp_outputs sau khi sẵn sàng.
- Khi nghỉ ngơi, kiểm tra các hoạt động có sẵn thay vì tạo một bản sao.
- Khi thất bại, hiển thị một lý do rõ ràng và một bước tiếp theo hữu ích.
6.Xem lại video
Nhập hình thức này vào kp_message:
{ "creation_id": "creation_xxx", "content": "Keep everything else and make the second scene easier to understand", "idempotency_key": "video-edit-20260901-001"}
Tiếp tục tìm kiếm cùng một sáng tạo với kp_get.
