# AI providers

> A tenant's own provider keys as credential_ref rows, and a registry of provider batch jobs with their results and a poll claim. Sandboxes live in ai-chat.

- Category: AI
- Module: `ai-keys`
- Modes: `managed`
- Docs: https://bettersupabase.com/docs/blocks/ai-keys
- Page: https://bettersupabase.com/blocks/ai-keys

## Install

```bash
npx better-supabase add ai-keys
```

The command also installs `updated-at`, `memberships`, `permissions`.

## Configure

Add the block to `better-supabase.config.ts`:

```ts
import { defineConfig } from "better-supabase/config";

export default defineConfig({
  blocks: {
    // Required by ai-keys; add installs them too.
    "updated-at": {},
    memberships: {},
    permissions: {},
    // Modes: "managed". The default is "managed".
    "ai-keys": { mode: "managed" },
  },
});
```

## Client

The block has no React entry yet. Its server-side TypeScript is in `better-supabase/blocks/ai-keys`.

## Events

- `ai_provider_key.deleted`
- `ai_provider_key.saved`

## Related blocks

Requires: [memberships](https://bettersupabase.com/blocks/memberships.md), [permissions](https://bettersupabase.com/blocks/permissions.md)

Works with: [ai-chat](https://bettersupabase.com/blocks/ai-chat.md)

## Recipes

- [AI provider settings](https://bettersupabase.com/recipes/ai-provider-settings.md): A settings card that lists the organization's own AI provider keys and models, adds a key to Vault and removes one.