Autenticación

Configure y verifique su clave API de forma segura.

Temas de API

Cada punto final de KPainter OpenAPI excepto GET/Health utiliza la clave API del usuario:

Authorization: Bearer <your_api_key>

Activar y copiar una clave de la Página clave de API.

Verificar la conexión primero

curl -s "https://api.kpainter.ai/openapi/v1/me" \  -H "Authorization: Bearer $KPAINTER_API_KEY"

Una respuesta exitosa devolve una cuenta segura y un resumen de plan. Verifique esto antes de crear contenido.

Comprar las claves con seguridad

  • Mantenga cada clave en una tienda secreta o en una conexión de agente confiable.
  • Nunca coloque una llave en el código de navegador, un paquete móvil, una captura de pantalla o logs.
  • No utilice una clave compartida para usuarios independientes.
  • Nunca echo la clave completa en un mensaje de error.
  • Solicite al usuario que vuelva a conectarse después de una redistribución de la clave.

Respuestas comunes

  • 401: la llave está ausente, invalida o inactiva.
  • 403: la cuenta no puede utilizar la capacidad solicitada.
  • 422: una combinación de campos o parámetros es invalida.
  • 429: las solicitudes son demasiado frecuentes; siga la guía de respuesta antes de retirarse.
  • Balance insuficiente: la creación informa de un estado descansado, créditos estimados y una acción disponible. No cree una duplicidad.

La activación, restablecimiento y eliminación de las claves de API permanecen en el sitio web de KPainter; el OpenAPI no gestiona las claves.