KPainter

Use o servidor MCP remoto do KPainter para criar vídeos, slides e conteúdo interativo de conhecimento com base nas suas próprias fontes.

Documentação

Início Rápido

Este exemplo conecta o KPainter MCP via stdio local e cria um primeiro resultado.

1. Prepare uma Chave de API

2. Configure o stdio

Quando o kp-mcp estiver instalado:

{
  "mcpServers": {
    "kpainter": {
      "command": "kp-mcp",
      "args": ["--stdio"],
      "env": {
        "KGP_API_KEY": "<your_api_key>"
      }
    }
  }
}

A partir do diretório de origem do 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. Leia as Capacidades

Chame kp_capabilities primeiro. Confirme que:

  • a conta está disponível
  • products inclui o resultado pretendido
  • as configurações de arquivo, vídeo, imagem ou aplicativo vêm desta resposta

4. Crie um Primeiro Resultado

Chame 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 file_id retornado em input_file_ids.

5. Consulte e Leia as Saídas

  • Chame kp_get periodicamente.
  • Continue aguardando durante o planejamento ou a produção.
  • Chame kp_outputs após a conclusão.
  • Quando pausado, inspecione available_actions em vez de criar uma duplicata.
  • Quando falhar, mostre um motivo claro e um próximo passo útil.

6. Refine um Vídeo

Passe esta estrutura 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 consultando a mesma criação com kp_get.

Leia a Seguir