Skip to main content

Connect OpenAI

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

Required permissions

Your DoiT account must have the Billing Profiles Admin permission.

Connect OpenAI accounts

The DoiT 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.

  2. Select the gear icon to open the Organization Settings page.

  3. Select Admin keys.

  4. Select Create new Admin key. The Create new admin key pane is displayed.

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

  6. In Permissions, select Restricted.

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

  8. In Usage API Scope, select Read.

  9. Select Create admin key. The Admin key is created.

  10. Select Copy to copy the Admin key.

    Caution

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

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

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

    OpenAI Intelligence api key

  13. Select Next to test the connection.

Test connection

To verify the setup:

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

    Caution

    If the test fails, we recommend that you open an expert inquiry.

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

    OpenAI connection custom role

Note

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.

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.