Perfil

Utilice puntos finales de perfil para inspeccionar la identificación de cuenta, el nivel, los créditos y la cuota restante de API del propietario de la clave API. Llame a este punto final antes de lotes grandes, después de trabajos importantes y durante verificaciones operativas.

Obtener perfil

GET /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY

Pedido

La solicitud no requiere cuerpo.

curl https://kittaai.com/api/open/v1/profile \
  -H "Authorization: Bearer KITTA_API_KEY"

Respuesta

{
  "user_id": "user_123",
  "api_quota_remaining": 988000,
  "tier": "pro",
  "credits": 1200
}

Trate los campos desconocidos como aditivos y evite fallar en los analizadores estrictos cuando la respuesta obtenga nuevos metadatos de cuenta o facturación.

Actualizar perfil

POST /api/open/v1/profile
Authorization: Bearer KITTA_API_KEY
Content-Type: application/json

{
  "webhookUrl": "https://example.com/webhooks/fishspeech"
}

Los campos actualizables están controlados por el servidor. Los campos desconocidos pueden ignorarse o rechazarse. Mantenga las actualizaciones de perfil separadas de la creación de trabajos multimedia para que un error de validación de perfil no pueda bloquear el trabajo de generación no relacionado.

Facturación y créditos

El punto final del perfil es la verificación ligera más segura antes de un lote. Puede mostrar si es probable que la cuenta tenga suficientes créditos o cuota para la siguiente operación, pero no es un sistema de reservas. Entre su cheque y la solicitud de los medios, otros trabajadores pueden consumir el saldo.

Para flujos de trabajo críticos, almacene la instantánea del perfil con la identificación del lote. Si un trabajo falla posteriormente por motivos de cuota, esa instantánea le ayuda a distinguir un saldo bajo preexistente del uso simultáneo por parte de otro proceso.

Errores