> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/cloud-cost-management/integrations/ai-providers/openai.md).

# OpenAI

Connecting OpenAI brings your OpenAI spend into Harness Cloud & AI Cost Management alongside your cloud costs. The connector uses an Admin API key with read-only access to pull usage and cost data from your OpenAI account. You can analyze AI spend in Cost Explorer, attribute it with Views and Cost Categories, and govern it with budgets and anomaly detection, the same way you manage cloud costs.

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

**OpenAI Admin API key:** An Admin API key with read-only access from your OpenAI account. The key lets Harness ingest billing and usage data. Go to the [OpenAI Admin API keys reference](https://developers.openai.com/api/reference/resources/admin/subresources/organization/subresources/admin_api_keys/methods/create) to create one.

### Set up the OpenAI connector <a href="#set-up-the-openai-connector" id="set-up-the-openai-connector"></a>

To connect OpenAI, go to **Cloud & AI Cost Management** > **Account Settings** > **AI Providers**. Click **AI Provider**, then select **OpenAI**.

#### Step 1: Name the connector <a href="#step-1-name-the-connector" id="step-1-name-the-connector"></a>

1. On the **Overview** panel, enter a **Name** for the connector.
2. Optionally, add a **Description** and **Tags** to organize and filter connectors.

<figure><img src="/files/h4Ptoe3wchQNrSs8ir8U" alt="OpenAI connector Overview panel"><figcaption><p>Click to view full size image</p></figcaption></figure>

3. Click **Continue**.

#### Step 2: Add the connector details <a href="#step-2-add-the-connector-details" id="step-2-add-the-connector-details"></a>

On the **Connector Details** panel, confirm the API endpoint and provide the OpenAI Admin API key as a Harness secret. Do the following:

1. In the **URL** field, do not change the default `https://api.openai.com/v1` unless you have a custom endpoint.

   <figure><img src="/files/TrKLF8ZUt6hZ8X87N7oL" alt="OpenAI connector URL field"><figcaption><p>Click to view full size image</p></figcaption></figure>
2. In the **API Key** field, click **Create or Select a Secret**.
   * To use an existing secret, select it from the list, then click **Apply Selected**.
   * To add a new secret, click **New Secret Text**, enter a **Secret Name**, and provide your OpenAI Admin API key as the **Secret Value**.

     <figure><img src="/files/QqLVlBCqgLJMldkqphr1" alt="New Secret Text panel for an OpenAI API key"><figcaption><p>Click to view full size image</p></figcaption></figure>

     Go to [Add and reference text secrets](/harness-ai/use-harness-platform/secrets/add-use-text-secrets.md) to review all secret creation options.
3. Click **Continue**.

#### Step 3: Verify the connection <a href="#step-3-verify-the-connection" id="step-3-verify-the-connection"></a>

On the **Connection Test** panel, Harness validates the API key against your OpenAI account. Once the verification is successful, click **Finish** to create the connector.

<figure><img src="/files/PfI62IRheeBKX6iWNta9" alt="OpenAI connector Connection Test panel"><figcaption><p>Click to view full size image</p></figcaption></figure>