KPainter

Inicio rápido

Este ejemplo conecta KPainter MCP a través de stdio local y crea un primer resultado.

1. Preparar una clave de API

2. Configurar stdio

Cuando kp-mcp está instalado:

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

Desde el directorio fuente de 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. Leer capacidades

Llame a kp_capabilities primero. Confirme que:

• la cuenta está disponible
• products incluye el resultado previsto
• la configuración de archivo, video, imagen o aplicación proviene de esta respuesta

4. Crear un primer resultado

Llame a 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 archivos fuente, llame a kp_upload_file primero y coloque cada file_id devuelto en input_file_ids.

5. Consultar y leer salidas

• Llame a kp_get periódicamente.
• Continúe esperando durante la planificación o producción.
• Llame a kp_outputs después de que esté listo.
• Cuando esté en pausa, inspeccione available_actions en lugar de crear un duplicado.
• Cuando falle, muestre una razón clara y un siguiente paso útil.

6. Refinar un video

Pase esta forma a kp_message:

{
  "creation_id": "creation_xxx",
  "content": "Keep everything else and make the second scene easier to understand",
  "idempotency_key": "video-edit-20260901-001"
}

Continúe consultando la misma creación con kp_get.

Leer a continuación

• Modos de transporte
• Herramientas disponibles
• Video explicativo