Skip to main content

Connect OpenAI

This page describes how to connect your OpenAI account to the console. Once connected, you can use your OpenAI usage and cost data within the console. See Working with AI data.

Required permissions​

Your DoiT account must have the Billing Profiles Admin permission.

Connect OpenAI accounts​

The console provides a step-by-step wizard to connect OpenAI accounts. To connect multiple OpenAI accounts, complete the setup wizard for each one.

Launch the wizard​

To launch the wizard:

  1. Select Data ingestion and integrations > Integrations from the top navigation mega menu.

  2. Find the OpenAI integration card:

    • Select Connect +, if you're setting up your first account.

    • Select Manage and then select Connect new account, if you're setting up an additional account.

The wizard contains two steps:

Configure an admin key​

To enable DoiT to programmatically access OpenAI, you must provide an admin key. This key is generated using the OpenAI dashboard. The admin key needs read access to the OpenAI usage API and, optionally, the OpenAI management API.

  1. Sign in to the OpenAI dashboard, select the gear icon to open the Organization Settings page.

  2. Select Admin keys.

  3. Select Create new Admin key.

  4. In the Create new admin key pane:

    • In Name, enter a name for your admin key.

    • In Permissions, select Restricted.

    • (Optional) In Management API Scope, select Read.

    • In Usage API Scope, select Read.

  5. Select Create admin key.

  6. Select Copy to copy the Admin key.

    Caution

    The key is only visible once. Ensure you copy the key before closing the browser window.

  7. Select Done to close the Save your key pane.

  8. In the console wizard, paste the admin key in the Admin key field.

    OpenAI Intelligence api key

  9. Select Next to test the connection.

Test connection​

To verify the setup:

  1. In the console, select Test connection. This should take a couple of seconds.

  2. When the test is successful, select Finish to complete the step-by-step wizard.

    If the test fails or you need further assistance, please open an expert inquiry.

What's next​

Upon initial connection, DoiT ingests the last 6 months of historical billing and usage data for each added account.

After you successfully connect your OpenAI account, we start importing your OpenAI billing and usage data. The process can take a few hours. You'll receive an email when the data is available for Cloud Analytics and other DoiT features.

"Key error" connection status​

An OpenAI account with a Key error status on the OpenAI assets page indicates that OpenAI is rejecting the provided admin key. For example, the key may have been revoked, or it may no longer have admin permissions to access the usage API.

While an account shows the Key error status, cost and usage data stops updating. To resolve the issue, update the admin key with a valid one.

Update admin key​

To update the admin key for a connected OpenAI account:

  1. Select Data ingestion and integrations > Integrations from the top navigation mega menu.

  2. Find the OpenAI integration card, select Manage.

  3. Locate the Organization ID of the OpenAI account whose admin key you want to update.

  4. Select the kebab menu (⋮) at the rightmost end of the row and select Update Admin key. The step-by-step wizard is displayed.

  5. Repeat the connection steps in Configure an admin key and Test connection.

Last updated on