> ## Documentation Index
> Fetch the complete documentation index at: https://help-empuls.xoxoday.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenAI

> Connect your own OpenAI API key for Empuls AI features — AI writing assistance, content moderation, skill mapping — using a model you control.

The OpenAI integration lets you bring your own OpenAI API key for the AI features inside Empuls. By default, AI features run on Empuls-managed models. If your organization has its own OpenAI contract — for example, to meet data-residency requirements, control model selection, or apply your own usage budgets — connect your key here and the AI features in Empuls will use it instead.

## Before you start

* You must be a **Super Admin** in Empuls.
* You need an OpenAI account with an API key that has access to the model tier you want to use (typically GPT-4 class for the best results).
* Confirm with your OpenAI account's billing owner that the projected token usage is within your plan limits — AI writing suggestions and content moderation can be high-volume.

## Connect OpenAI

<Steps>
  <Step title="Generate an OpenAI API key">
    In the OpenAI dashboard, navigate to **API Keys** and create a new secret key. Scope it tightly if your plan supports project-level scopes.
  </Step>

  <Step title="Open the OpenAI card in Empuls">
    From the Integrations hub, click **OpenAI → Configure**.
  </Step>

  <Step title="Paste your API key">
    Empuls validates the key against OpenAI's API. A successful response shows the available models.
  </Step>

  <Step title="Pick a default model">
    Choose which model Empuls should use for AI features. The picker only shows models your key has access to.
  </Step>

  <Step title="Pick which Empuls AI features use your key">
    By default, every AI feature uses your key once you connect. Optionally narrow the scope to specific features — for example, only **AI writing suggestions** but not **AI content moderation**.
  </Step>

  <Step title="Save">
    AI features switch to your key on the next request.
  </Step>
</Steps>

## What's covered

| Empuls AI feature                                             | Default model usage |
| ------------------------------------------------------------- | ------------------- |
| AI writing suggestions (recognition citations, wish messages) | Uses your key       |
| AI content moderation                                         | Uses your key       |
| AI skill mapping                                              | Uses your key       |
| Em Copilot                                                    | Uses your key       |

You can toggle each feature on or off per the previous step.

## Monitor usage

Empuls surfaces a usage snapshot per feature (calls/day, tokens/day) on the OpenAI integration page so you can track consumption against your OpenAI plan. For detailed billing, check your OpenAI dashboard.

## Reconnect or disconnect

* **Reconnect** — Replace the key when you rotate credentials in OpenAI. Empuls validates the new key before swapping.
* **Disconnect** — Revert to Empuls-managed AI. The key is removed from Empuls; you may want to revoke it in OpenAI as well.

## Limits and gotchas

* OpenAI rate limits apply per your account tier. Heavy AI usage may hit rate limits — Empuls will fall back to managed AI gracefully if configured.
* Costs are billed to your OpenAI account, not Empuls.
* The key is stored encrypted in Empuls. Rotate it on a schedule that matches your security policy.

## Related

<CardGroup cols={2}>
  <Card title="AI settings" href="/admin/ai/ai-settings">
    Toggle individual AI features on or off.
  </Card>

  <Card title="AI skill mapping" href="/admin/ai/ai-skill-mapping">
    One of the features that can use your OpenAI key.
  </Card>

  <Card title="Em Copilot" href="/admin/ai/empuls-copilot">
    Conversational AI assistant.
  </Card>
</CardGroup>