QuickStart
Este exemplo conecta o KPainter MCP sobre o estdio local e cria um primeiro resultado.
1 – Preparar uma chave de API
- Inscreva-se no KPainter
- Abra o API Página chave.
- Ative e copie a chave.
- Armazená-lo na configuração segura do cliente MCP.
2 – Configuração do estadio
Quando o kp-mcp é instalado:
{ "mcpServers": { "kpainter": { "command": "kp-mcp", "args": ["--stdio"], "env": { "KGP_API_KEY": "<your_api_key>" } } }}Da diretoria de fontes do serviço KGP:
{ "mcpServers": { "kpainter": { "command": "python", "args": ["-m", "src.mcp_server", "--stdio"], "cwd": "/path/to/kgp-service", "env": { "KGP_API_KEY": "<your_api_key>" } } }}3 – Leia Capacidades
Primeiro ligue às capacidades. Confirmamos que:
- A conta está disponível
- Os produtos incluem o resultado pretendido
- configurações de arquivo, vídeo, imagem ou aplicativo vêm desta resposta
4 – Crie um primeiro resultado
Conheça o 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" }}Para arquivos de origem, chame kp_upload_file primeiro e coloque cada arquivo_id devolvido em input_file_ids.
5 – Poll e leitura de resultados
- Chamando kp_get periodicamente.
- Continue a esperar durante o planejamento ou produção.
- Chamando kp_outputs depois de pronto.
- Quando descansado, inspire as ações disponíveis em vez de criar um duplicado.
- Quando falhar, mostrar uma razão clara e um próximo passo útil.
6 – Refinar um vídeo
Passar essa forma para kp_message:
{ "creation_id": "creation_xxx", "content": "Keep everything else and make the second scene easier to understand", "idempotency_key": "video-edit-20260901-001"}Continue a pesquisar a mesma criação com kp_get.