Autenticación de la API

Rivya API usa claves API para acceso de servidor a servidor.

Una clave API no es lo mismo que una sesión de navegador. No uses cookies, estado de sesión de Better Auth ni un token personal del navegador como credencial de API pública.

Formato del header

Envía la clave en el header Authorization:

Authorization: Bearer rvya_sk_...

La clave completa solo se muestra una vez al crearla. Rivya guarda un hash y un prefijo visible, no el secreto completo.

Crear una clave

1. Inicia sesión en Rivya.
2. Abre ajustes de API Keys.
3. Crea una clave con los scopes que necesitas.
4. Copia la clave completa inmediatamente.
5. Guárdala en un gestor de secretos del servidor o en una variable de entorno.

No pongas la clave en JavaScript del cliente, bundles de apps móviles, repos públicos, eventos de analytics ni logs.

Scopes actuales

La primera versión documenta estos scopes:

• models:read
• generations:create
• generations:read
• files:create
• files:read
• credits:read
• webhooks:manage
• chat:create
• chat:read

Las claves nuevas creadas en Settings incluyen por defecto los scopes documentados. Las claves más antiguas quizá deban recrearse antes de usar Files API, API Webhooks o Chat API.

Revocar y rotar

Si una clave queda expuesta:

1. Revoca la clave antigua desde Settings.
2. Crea una clave nueva.
3. Actualiza el secreto del servidor.
4. Confirma que la nueva clave funciona con GET /api/v1/credits.
5. Elimina la clave antigua de sistemas de build, logs y variables de despliegue.

Las claves revocadas devuelven api_key_revoked.

Errores de autenticación

Errores comunes de autenticación:

• api_key_missing
• api_key_invalid
• api_key_revoked
• api_key_expired
• api_scope_denied
• public_api_disabled

Consulta errores y límites de la API para ver la tabla completa de errores públicos.

Páginas relacionadas

• Inicio rápido de la API
• Créditos de la API
• Errores y límites de la API
• Autenticación y acceso en Rivya