Autenticación

Todas las peticiones a la API necesitan una clave de API de tu cuenta, enviada en la cabecera Authorization:

Authorization: Bearer hx_TU_CLAVE

Las claves empiezan siempre por hx_. Si falta, está mal escrita o se ha revocado, la API responde 401:

{ "error": { "message": "Clave de API no válida o revocada. Crea una en sabiuco.app/desarrolladores/claves.", "type": "invalid_request_error", "param": null, "code": "invalid_api_key" } }

Crear y revocar claves

• Se crean en Claves de API. Puedes tener hasta 10 activas.
• La clave completa solo se muestra al crearla. Sabiuco guarda únicamente una huella cifrada (SHA-256), así que nadie, ni siquiera el equipo de Sabiuco, puede volver a verla. Si la pierdes, crea otra y revoca la antigua.
• Revocar una clave la desactiva al instante: las peticiones que la usen empezarán a recibir 401.
• En el panel verás el prefijo de cada clave (hx_AbCdEf…), cuándo se creó y cuándo se usó por última vez.

A qué da acceso una clave

Una clave actúa en nombre de tu cuenta:

• Consume los tokens incluidos en tu plan y, cuando se acaban, tu saldo.
• Puede usar tus asistentes, y solo los tuyos.
• Si tu cuenta se suspende, todas sus claves dejan de funcionar (403).

Dónde guardarla

• ✅ En variables de entorno o en el gestor de secretos de tu plataforma (Vercel, Docker, GitHub Actions…).
• ✅ Solo en tu servidor o backend.
• ❌ Nunca en código que se ejecute en el navegador ni en una app móvil: cualquiera podría extraerla.
• ❌ Nunca en un repositorio, aunque sea privado.

Si crees que una clave se ha filtrado, revócala y crea otra. Consulta también Seguridad y buenas prácticas.