AI features in notebooks

marimo AI features in ozeye notebooks can call ozeye chat completions without exposing raw API keys to notebook Python code.

Set up

  1. Create an API key in Dashboard → API keys.
  2. Open Dashboard → Notebooks and select the key for notebook AI.
  3. When the notebook page loads, ozeye mints a short-lived notebook token scoped to chat completions.

API configuration

To attach or change the AI key for a notebook file, call PUT /v1/notebooks/files/{id}/ai-connection:

{
  "api_key_id": "key_uuid_from_dashboard"
}

Security model

  • Raw API keys are not stored in browser localStorage.
  • Notebook delegation tokens use the oznb_* prefix and expire after a short window.
  • Notebook tokens are scoped to /v1/chat/completions.
  • Revoking the selected API key prevents future notebook AI requests after reload.